The location (URL) of the object it is linked to. Changes done on it are reflected on the object it relates to. Both the Document and Window interface have such a linked Location, accessible via Document.location and Window.location respectively.

interface Location {
    ancestorOrigins: DOMStringList;
    hash: string;
    host: string;
    hostname: string;
    href: string;
    origin: string;
    pathname: string;
    port: string;
    protocol: string;
    search: string;
    assign(url): void;
    reload(): void;
    replace(url): void;
    toString(): string;
}

Properties

ancestorOrigins: DOMStringList

Returns a DOMStringList object listing the origins of the ancestor browsing contexts, from the parent browsing context to the top-level browsing context.

hash: string

Returns the Location object's URL's fragment (includes leading "#" if non-empty).

Can be set, to navigate to the same URL with a changed fragment (ignores leading "#").

host: string

Returns the Location object's URL's host and port (if different from the default port for the scheme).

Can be set, to navigate to the same URL with a changed host and port.

hostname: string

Returns the Location object's URL's host.

Can be set, to navigate to the same URL with a changed host.

href: string

Returns the Location object's URL.

Can be set, to navigate to the given URL.

origin: string

Returns the Location object's URL's origin.

pathname: string

Returns the Location object's URL's path.

Can be set, to navigate to the same URL with a changed path.

port: string

Returns the Location object's URL's port.

Can be set, to navigate to the same URL with a changed port.

protocol: string

Returns the Location object's URL's scheme.

Can be set, to navigate to the same URL with a changed scheme.

search: string

Returns the Location object's URL's query (includes leading "?" if non-empty).

Can be set, to navigate to the same URL with a changed query (ignores leading "?").

Methods

  • Navigates to the given URL.

    Parameters

    • url: string | URL

    Returns void

  • Reloads the current page.

    Returns void

  • Removes the current page from the session history and navigates to the given URL.

    Parameters

    • url: string | URL

    Returns void

  • Returns string