AboutSupportDeveloper GuideVersion 46.151.100.37

Generated when an extension creates a tab in this window (e.g. an extension called chrome.tabs.create). The runtime auto-creates a backing View and fires this event so the host can attach or destroy it. Only fires on windows created with chromeBrowser: true.

interface ExtensionTabCreatedEvent {
    activeTabIdentity?: Identity;
    destination: ChildViewDestination;
    disposition: ContentCreationDisposition;
    features: string;
    frameName: string;
    name: string;
    parsedFeatures: Partial<WindowOptions>;
    topic: "window";
    type: "extension-tab-created";
    url: string;
    uuid: string;
    viewIdentity: Identity;
}

Properties

activeTabIdentity?: Identity

Identity of the view that was active when the extension triggered tab creation. Undefined if no tab was active (e.g. the first tab in a newly-opened window).

Recommended placement for the auto-created View. This is complementary to disposition, which describes the requested browser creation behavior.

Normalized disposition of the tab creation request, aligned with child-view-created.

  • foreground-tab — new tab opened in the foreground
  • background-tab — new tab opened in the background
  • popup — new popup window
  • new-window — new browser window
  • default — replace/reuse current tab (currentTab, singletonTab)
  • other — any other or unrecognized Chromium disposition
features: string

Raw window.open() features string, if provided by CreateContentsParams.

frameName: string

Target frame name from window.open(url, name), if provided.

name: string
parsedFeatures: Partial<WindowOptions>

Parsed window options derived from the features string.

topic

The "kebab-case" classname of the emitter that raised the event.

OpenFin.Frame is represented as iframe.

type

The type of event that was raised. Equal to the typename of the event payload in "kebab case".

Guaranteed to be unique within each topic, but can be repeated between topics (e.g. WebContentsEvents.CrashedEvent and ApplicationEvents.CrashedEvent).

url: string

Initial URL the extension requested.

uuid: string
viewIdentity: Identity

Identity of the auto-created view backing the new tab.