SafariBrowserTab Class Reference

Inherits from
Technology area
Safari Extensions
Availability
Available in Safari 5.0 and later.

Overview

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

Tasks

Getting Information About Browser Tabs

Working with Browser Tabs

Properties

browserWindow

The browser window containing this tab.

readonly attribute SafariBrowserWindow browserWindow
Availability

page

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

readonly attribute SafariWebPageProxy page
Availability

reader

The Reader view associated with this tab.

readonly attribute SafariReader reader
Availability

title

The tab’s current title.

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.

Availability

url

The URL loaded in this tab.

attribute DOMString url
Discussion

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

Availability

Methods

activate

Selects the tab.

void activate ();
Discussion

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

Availability
  • Available in Safari 5.0 and later.

close

Requests that the tab should close.

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.

Availability
  • Available in Safari 5.0 and later.

visibleContentsAsDataURL

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

void visibleContentsAsDataURL (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.

Availability
  • Available in Safari 5.0 and later.