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 origin = window.location.origin;

kokeile itse

let origin = location.origin;

kokeile itse

Location-objekti ominaisuudet

ominaisuus kuvaus
hash asettaa tai palauttaa URL:n ankkuriosan (#).
host asettaa tai palauttaa URL:n isäntänimen ja portin.
hostname asettaa tai palauttaa URL:n isäntänimen.
href asettaa tai palauttaa koko URL:n.
origin palauttaa URL:n protokollan, isäntänimen ja portin.
pathname asettaa tai palauttaa URL:n polun.
port asettaa tai palauttaa URL:n portin.
protocol asettaa tai palauttaa URL:n protokollan.
search asettaa tai palauttaa URL:n hakuketjun osan.

Location-objekti menetelmät

menetelmä kuvaus
assign() lataa uuden dokumentin.
reload() lataa uudelleen nykyinen dokumentti.
replace() korvaa nykyisen dokumentin uudella dokumentilla.

Location-objekti kuvaus

Location-objekti tallennetaan Window-objektin Location-ominaisuuteen ja se edustaa kyseisen ikkunan nykyisesti näyttämää dokumentin Web-osoitetta. Sen href-ominaisuussisältää dokumentin täyden URL:n, muiden ominaisuuksien avulla kuvataan URL:n eri osia. Nämä ominaisuudet ovat hyvin samanlaisia Anchor-objektin (tai Area-objektin) URL-ominaisuuksien kanssa. 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ä, mutta Location-objekti edustaa selaimen nykyisesti näyttämää dokumentin URL:ää (tai sijaintia). Mutta Location-objekti voi tehdä paljon enemmän kuin tämän, se voi myös hallita selaimen näyttämää dokumentin sijaintia. Jos URL-merkkijonoa asetetaan Location-objektiin tai sen href-ominaisuuteen, selain lataa uuden URL:n mukaisen dokumentin ja näyttää sen.

paitsi, että asetetaan location tai location.href täydellä URL:llä korvaamaan nykyinen URL, voidaan myös muuttaa osaa URL:ää, vain asettamalla Location-objektin muiden ominaisuuksien arvot. Tämä luo uuden URL:n, jonka osa on erilainen kuin alkuperäinen URL, selain lataa sen ja näyttää sen. Esimerkiksi, olettaen, että on asetettu Location-objektin hash-ominaisuus，niin selain siirtyy nykyisessä dokumentissa olevaan määritettyyn sijaintiin. Samoin, jos on asetettu search-ominaisuussilloin selain lataa uudelleen URL:n, joka on lisännyt uuden hakuketjun.

Paitsi URL-ominaisuuden 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.