Chartbreaker
    Preparing search index...

    Interface Location

    The Location interface represents 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.

    MDN Reference

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

    Properties

    ancestorOrigins: DOMStringList

    The ancestorOrigins read-only property of the Location interface is a static DOMStringList containing, in reverse order, the origins of all ancestor browsing contexts of the document associated with the given Location object.

    MDN Reference

    hash: string

    The hash property of the Location interface is a string containing a "#" followed by the fragment identifier of the location URL. If the URL does not have a fragment identifier, this property contains an empty string, "".

    MDN Reference

    host: string

    The host property of the Location interface is a string containing the host, which is the hostname, and then, if the port of the URL is nonempty, a ":", followed by the port of the URL. If the URL does not have a hostname, this property contains an empty string, "".

    MDN Reference

    hostname: string

    The hostname property of the Location interface is a string containing either the domain name or IP address of the location URL. If the URL does not have a hostname, this property contains an empty string, "". IPv4 and IPv6 addresses are normalized, such as stripping leading zeros, and domain names are converted to IDN.

    MDN Reference

    href: string

    The href property of the Location interface is a stringifier that returns a string containing the whole URL, and allows the href to be updated.

    MDN Reference

    origin: string

    The origin read-only property of the Location interface returns a string containing the Unicode serialization of the origin of the location's URL.

    MDN Reference

    pathname: string

    The pathname property of the Location interface is a string containing the path of the URL for the location. If there is no path, pathname will be empty: otherwise, pathname contains an initial '/' followed by the path of the URL, not including the query string or fragment.

    MDN Reference

    port: string

    The port property of the Location interface is a string containing the port number of the location's URL. If the port is the default for the protocol (80 for ws: and http:, 443 for wss: and https:, and 21 for ftp:), this property contains an empty string, "".

    MDN Reference

    protocol: string

    The protocol property of the Location interface is a string containing the protocol or scheme of the location's URL, including the final ":".

    MDN Reference

    search: string

    The search property of the Location interface is a search string, also called a query string, that is a string containing a "?" followed by the parameters of the location's URL. If the URL does not have a search query, this property contains an empty string, "".

    MDN Reference

    Methods

    • The assign() method of the Location interface causes the window to load and display the document at the URL specified. After the navigation occurs, the user can navigate back to the page that called Location.assign() by pressing the "back" button.

      MDN Reference

      Parameters

      • url: string | URL

      Returns void

    • The reload() method of the Location interface reloads the current URL, like the Refresh button.

      MDN Reference

      Returns void

    • The replace() method of the Location interface replaces the current resource with the one at the provided URL. The difference from the assign() method is that after using replace() the current page will not be saved in session History, meaning the user won't be able to use the back button to navigate to it. Not to be confused with the String method String.prototype.replace().

      MDN Reference

      Parameters

      • url: string | URL

      Returns void

    • Returns string