Get Title

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The Get Title command of the WebDriver API returns the document title of the current top-level browsing context. This is equivalent to reading the Document.title property in JavaScript.

Syntax

Method URI template
GET /session/{session id}/title

URL parameters

session id

Identifier of the session.

Return value

A string containing the title of the current document, equivalent to the value of Document.title.

Errors

Invalid session id

Session does not exist.

No such window

The window object has been discarded, indicating that the tab or window has been closed.

Examples

Retrieving the page title

With a WebDriver server running on localhost:4444, assume an active session has navigated to https://example.org. You can retrieve the document title by using the following command, replacing ID with the sessionId from the New Session response:

bash
curl -i http://localhost:4444/session/ID/title

The server responds with the document title as shown here:

http
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8

{"value":"Example Domain"}

Specifications

Specification
WebDriver
# get-title

Browser compatibility