Safari Reference Library Apple Developer
Search

SafariBrowserTab Class Reference

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

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 (void);

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 (void);

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

Returns a data URL for an image of the visible contents of the tab.

DOMString visibleContentsAsDataURL (void);

Return Value

A data URL for an image of the visible contents of the tab.

Discussion

The image is returned as a base-64 encoded PNG.

Availability
  • Available in Safari 5.0 and later.



Last updated: 2010-06-30

Did this document help you? Yes It's good, but... Not helpful...