Requests

initialSetup

• "NewTab Messages".InitialSetupRequest
• Returns "NewTab Messages".InitialSetupResponse
• See the initialSetupResponse section of example of initial data
• See also
  • Widget Config for the initial page widgets
  • Update Notification for the optional data
  • Customizer Drawer Feature Flags for optional feature flags like the customizer drawer about release notes (windows only).

Notifications

contextMenu

• "NewTab Messages".ContextMenuNotification
• Sent when the user right-clicks in the page
• Note: Other widgets might prevent this (and send their own, eg: favorites)
• Sends: "NewTab Messages".ContextMenuNotify
• Example:

{
  "visibilityMenuItems": [
    {
      "id": "favorites",
      "title": "Favorites"
    },
    {
      "id": "privacyStats",
      "title": "Privacy Stats"
    }
  ]
}
Copy

open

• "NewTab Messages".OpenNotification
• Sent when the user clicks on a link, such as 'settings'
• Sends: "NewTab Messages".OpenAction
• Example:

{
  "target": "settings"
}
Copy

telemetryEvent

• "NewTab Messages".TelemetryEventNotification
• These are generic events that might be useful to observe. For example, you can use these to decide when to send pixels.
• Sends a standard format { attributes: { name: string', value?: any } } - see telemetryEvent
• Example:

{
  "attributes": {
    "name": "stats_toggle",
    "value": "show_more"
  }
}
Copy

reportInitException

• "NewTab Messages".ReportInitExceptionNotification
• Sent when the application fails to initialize (for example, a JavaScript exception prevented it)
• Sends: { message: string } - see "NewTab Messages".ReportInitExceptionNotify

reportPageException

• "NewTab Messages".ReportPageExceptionNotification
• Sent when the application failed after initialization (for example, a JavaScript exception prevented it)
• Sends: { message: string } - see "NewTab Messages".ReportPageExceptionNotify