Special Error Page

Displays SSL certificate errors and malicious site warnings.

Requests

initialSetup

"SpecialError Messages".InitialSetupRequest

Configure initial special error page settings.

Types:

• Response: "SpecialError Messages".InitialSetupResponse

Example for a phishing warning:

{
  "locale": "en",
  "env": "production",
  "platform": {
    "name": "macos"
  },
  "errorData": {
    "kind": "phishing",
    "url": "https://malicious-example.com"
  },
  "theme": "light",
  "themeVariant": "default"
}
Copy

Example for a malware warning:

{
  "locale": "en",
  "env": "production",
  "platform": {
    "name": "windows"
  },
  "errorData": {
    "kind": "malware",
    "url": "https://malware-example.com"
  },
  "theme": "dark",
  "themeVariant": "default"
}
Copy

Example for an SSL expired certificate error:

{
  "locale": "en",
  "env": "production",
  "platform": {
    "name": "macos"
  },
  "errorData": {
    "kind": "ssl",
    "errorType": "expired",
    "domain": "expired.badssl.com"
  },
  "theme": "light",
  "themeVariant": "default"
}
Copy

Example for an SSL wrong host error:

{
  "locale": "en",
  "env": "production",
  "platform": {
    "name": "macos"
  },
  "errorData": {
    "kind": "ssl",
    "errorType": "wrongHost",
    "domain": "wrong.host.badssl.com",
    "eTldPlus1": "badssl.com"
  },
  "theme": "light",
  "themeVariant": "default"
}
Copy

Error Data Types

Malicious Site (kind: phishing | malware | scam):

• kind: Type of malicious site
• url: The URL of the malicious site

SSL Errors (kind: ssl):

• errorType: One of expired, invalid, selfSigned, wrongHost
• domain: The domain with the certificate issue
• eTldPlus1: (Only for wrongHost) The eTLD+1 of the expected domain

Available theme variants: default, coolGray, slateBlue, green, violet, rose, orange, desert

Subscriptions

onThemeUpdate

• "SpecialError Messages".OnThemeUpdateSubscription
• Sends "SpecialError Messages".OnThemeUpdateSubscribe whenever the browser theme changes.
• For example:

{
  "theme": "dark",
  "themeVariant": "default"
}
Copy

• Or, with a different theme variant:

{
  "theme": "light",
  "themeVariant": "violet"
}
Copy

• Available theme variants: default, coolGray, slateBlue, green, violet, rose, orange, desert

Notifications

leaveSite

• "SpecialError Messages".LeaveSiteNotification
• Sent when the user clicks the "Leave Site" or "Go Back" button to navigate away from the dangerous site.

visitSite

• "SpecialError Messages".VisitSiteNotification
• Sent when the user chooses to proceed to the site despite the warning.

advancedInfo

• "SpecialError Messages".AdvancedInfoNotification
• Sent when the user clicks the "Advanced" button to view more details about the error.

reportInitException

• "SpecialError Messages".ReportInitExceptionNotification
• Reports errors during page initialization.

{
  "message": "Failed to initialize special error page"
}
Copy

reportPageException

• "SpecialError Messages".ReportPageExceptionNotification
• Reports errors during page operations.

{
  "message": "Failed to render error details"
}
Copy