Window Location objekti

Window Location objekti

Location-objekti sisältää tietoja nykyisestä URL:stä.

Location-objekti on ikkunan objektin ominaisuus.

Location-objekti voidaan saavuttaa seuraavilla tavoilla:

window.location tai vain location

Esimerkki

let alkuperä = window.location.origin;

Kokeile itse

let alkuperä = location.origin;

Kokeile itse

Location-objektin ominaisuudet

ominaisuus kuvaus
hash Aseta tai palauta URL:n ankkuriosa (#).
host Aseta tai palauta URL:n isäntänimi ja portti.
hostname Aseta tai palauta URL:n isäntänimi.
href Aseta tai palauta koko URL:n.
origin Palauta URL:n protokolla, isäntänimi ja portti.
pathname Aseta tai palauta URL:n polku.
port Aseta tai palauta URL:n portti.
protocol Aseta tai palauta URL:n protokolla.
search Aseta tai palauta URL:n hakujonon osa.

Location-objektin menetelmät

menetelmä kuvaus
assign() Lataa uusi dokumentti.
reload() Lataa uudelleen nykyinen dokumentti.
replace() Korvaa nykyisen dokumentin uudella dokumentilla.

Location-objektin kuvaus

Location-objekti tallennetaan Window-objektin Location-ominaisuuteen ja se edustaa kyseisen ikkunan nykyisesti näytettävän dokumentin Web-osoitetta. Se href ominaisuusSisältää dokumentin täyden URL:n, muiden ominaisuuksien kuvailevan URL:n eri osia. Nämä ominaisuudet ovat hyvin samanlaisia kuin Anchor-objektin (tai Area-objektin) URL-ominaisuudet. Kun Location-objekti muunnetaan merkkijonoksi, palautetaan href-ominaisuuden arvo. Tämä tarkoittaa, että voit käyttää ilmaisua location korvaamaan location.href.

Kuitenkin Anchor-objekti edustaa dokumentin hyperlinkkiä, kun taas Location-objekti edustaa selaimessa nykyisesti näytettävän dokumentin URL:ää (tai sijaintia). Mutta Location-objekti voi tehdä paljon enemmän kuin tämän, se voi myös hallita selaimessa näytettävän dokumentin sijaintia. Jos annetaan URL-merkkijono Location-objektille tai sen href-ominaisuudelle, selain lataa uuden URL:n osoittaman dokumentin ja näyttää sen.

Paitsi että voit asettaa location tai location.href täydellä URL:llä korvaamaan nykyisen URL:n, voit myös muuttaa osaa URL:stä antamalla Arvo-objektin muiden ominaisuuksille arvon. Tämä luo uuden URL:n, jonka osa on erilainen kuin alkuperäinen URL, selain lataa sen ja näyttää sen. Esimerkiksi, jos asetetaan Location-objektin hash ominaisuusSiinä tapauksessa selain siirtyy nykyisessä dokumentissa olevaan määritettyyn sijaintiin. Samoin, jos on asetettu search ominaisuusSiinä tapauksessa selain lataa uudelleen URL:n, joka on varustettu uudella hakujonolla.

paitsi URL-ominaisuuksien lisäksi, Location objektin reload() menetelmäVoit uudelleenladata nykyisen dokumentin,replace() Voit ladata uuden dokumentin ilman, että sinun täytyy luoda uusi historiallinen merkintä sille, eli uusi dokumentti korvaa nykyisen dokumentin selaimen historiallisessa listassa.