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.
Note that all Location
methods can return a SecurityError
if the Location
object's
relevant Document
's origin is not same origin-domain with the entry settings object's origin.
See: https://html.spec.whatwg.org/#dom-location-href
(JavaScript docs)
Returns a String
containing the Unicode serialization of the origin of the represented
URL, that is:
- For URL using the http or https, the scheme followed by
'://'
, followed by the domain,
followed by ':'
, followed by the port (the default port, 80 and 443 respectively, if
explicitely specified);
- For URL using
file: scheme
, the value is browser dependant.
- For URL using the blob: scheme, the origin of the URL following blob:. E.g
"blob:https://mozilla.org" will have "https://mozilla.org".
(JavaScript docs)
Returns a String
representing the protocol scheme of the URL, including the final ':'.
Example: http:
(JavaScript docs)
Returns a String
containing the host (i.e. hostname) and then, if the port of the
URL is nonempty, a ':', and the port of the URL.
Example: hitchhikers.com:4242
(JavaScript docs)
Returns a String
which is the domain of the URL
Example: mozilla.com
(JavaScript docs)
Returns a String
containing the port number or ""
if there is no port.
(JavaScript docs)
Returns a String
containing an initial '/' followed by the path of the URL.
(JavaScript docs)
Returns a String
which is a search string, also called a query string, that is a String
containing a '?' followed by the parameters of the URL.
These can then be further parsed via another library.
(JavaScript docs)
Returns a String
containing a '#' followed by the fragment
identifier of the URL. The fragment is not percent-decoded.
(JavaScript docs)
The type returned in the event of a conversion error.
type Error = ConversionError
The type returned in the event of a conversion error.
type Error = ConversionError
The type returned in the event of a conversion error.
type Error = ConversionError
The type returned in the event of a conversion error.
type Error = ConversionError
The type returned in the event of a conversion error.
Checks whenever a given Reference if of type Self
.
Converts a given reference into a concrete reference-like wrapper. Doesn't do any type checking; highly unsafe to use! Read more
This method tests for self
and other
values to be equal, and is used by ==
. Read more
This method tests for !=
.
Performs copy-assignment from source
. Read more
Formats the value using the given formatter. Read more
Creates owned data from borrowed data, usually by cloning. Read more
🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static