Back to Content

Get Title

files/en-us/web/webdriver/reference/classic/commands/gettitle/index.md

latest1.7 KB
Original Source

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 {{domxref("Document.title")}} property in JavaScript.

Syntax

MethodURI 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 {{domxref("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

{{Specifications}}

Browser compatibility

{{Compat}}