Safari Developer Library

Developer

SafariBrowserTab Class Reference

Options
Deployment Target:

On This Page

SafariBrowserTab

Instances of the SafariBrowserTab class represent tabs in the user’s browser window.

  • The browser window containing this tab.

    Declaration

    readonly attribute SafariBrowserWindow browserWindow

  • private Property

    Indicates whether this tab uses Private Browsing.

    Declaration

    readonly attribute boolean private

  • reader Property

    The Reader view associated with this tab.

    Declaration

    readonly attribute SafariReader reader

  • title Property

    The tab’s current title.

    Declaration

    readonly attribute DOMString title

    Discussion

    The tab’s title is the same as the title of the webpage in most cases. For example, the title of the webpage may be truncated for display, but the value of this property is not truncated.

  • page Property

    A proxy object for the the web content displayed in the tab.

    Declaration

    readonly attribute SafariWebPageProxy page

  • url Property

    The URL loaded in this tab.

    Declaration

    attribute DOMString url

    Discussion

    Setting this attribute to a new value loads the page at the new URL in the tab.

  • Fetches a data URL for an image of the tab’s visible contents.

    Declaration

    void visibleContentsAsDataURL (in function callback);

    Parameters

    callback

    A function that takes a single DOMString argument, the image of the visible contents of the tab as a data URL.

    Discussion

    The data URL is a base-64 encoded PNG.

  • Selects the tab.

    Declaration

    void activate ();

    Discussion

    Depending on the content that is currently loaded in the tab, this method may change the keyboard focus.

  • Requests that the tab should close.

    Declaration

    void close ();

    Discussion

    This method behaves like clicking the tab’s close button—it does not necessarily cause the tab to close. After a tab closes, the value of all of its properties is undefined and all of its prototype’s methods return undefined.