Caution: This version of this document is no longer maintained. For the latest documentation, see


A WebFrame class encapsulates the data displayed in a WebFrameView object. There is only ever one WebFrame object per frame displayed in a WebView. An entire webpage is represented by a hierarchy of WebFrame objects in which the root object is called the main frame.

Each WebFrame also has a WebDataSource object that manages the loading of frame content. You use the loadRequest() method to initiate an asynchronous client request which will create a provisional data source. The provisional data source will transition to a committed data source once any data has been received.

There are predefined frame names that you can use to refer to a WebFrame. The following frame names are defined:

Frame names may also be specified in the HTML source, or set by clients.

Some of the WebFrame methods are described below (listed alphabetically):