Struct Location

pub struct Location(/* private fields */);

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)

Implementations

impl Location

pub fn href(&self) -> Result<String, SecurityError>

The entire URL.

(JavaScript docs)

pub fn origin(&self) -> Result<String, SecurityError>

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)

pub fn protocol(&self) -> Result<String, SecurityError>

Returns a String representing the protocol scheme of the URL, including the final ‘:’.

Example: http:

(JavaScript docs)

pub fn host(&self) -> Result<String, SecurityError>

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)

pub fn hostname(&self) -> Result<String, SecurityError>

Returns a String which is the domain of the URL

Example: mozilla.com

(JavaScript docs)

pub fn port(&self) -> Result<String, SecurityError>

Returns a String containing the port number or "" if there is no port.

(JavaScript docs)

pub fn pathname(&self) -> Result<String, SecurityError>

Returns a String containing an initial ‘/’ followed by the path of the URL.

(JavaScript docs)

pub fn search(&self) -> Result<String, SecurityError>

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)

pub fn hash(&self) -> Result<String, SecurityError>

Returns a String containing a ‘#’ followed by the fragment identifier of the URL. The fragment is not percent-decoded.

(JavaScript docs)

Trait Implementations

impl AsRef<Reference> for Location

fn as_ref(&self) -> &Reference

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Location

fn clone(&self) -> Location

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Location

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Location> for Reference

fn from(value: Location) -> Self

Converts to this type from the input type.

impl InstanceOf for Location

fn instance_of(reference: &Reference) -> bool

Checks whenever a given Reference if of type Self.

impl PartialEq for Location

fn eq(&self, other: &Location) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ReferenceType for Location

unsafe fn from_reference_unchecked(reference: Reference) -> Self

Converts a given reference into a concrete reference-like wrapper. Doesn’t do any type checking; highly unsafe to use!

impl<'_r> TryFrom<&'_r Reference> for Location

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(reference: &Reference) -> Result<Self, Self::Error>

Performs the conversion.

impl<'_r> TryFrom<&'_r Value> for Location

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: &Value) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Location> for Reference

type Error = Void

The type returned in the event of a conversion error.

fn try_from(value: Location) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Reference> for Location

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(reference: Reference) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Value> for Location

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: Value) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Location

impl JsSerialize for Location

impl StructuralPartialEq for Location