База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

`URL.origin`, `URL.pathname` и `URL.search`

Разграничавайте произхода, пътя и заявката на разчетен URL адрес и четете отделни параметри, без да разделяте адреса ръчно.

Версия: Current web platform; runtime support varies

Синтаксис

const url = new URL(input);
const resolved = new URL(input, base);

url.origin;
url.pathname;
url.search;

url.pathname = "/catalog";
url.search = "page=2";

origin, pathname и search са свойства на екземпляр на URL, а не методи. URL е API на уеб платформата, а не част от ECMAScript 2024, затова проверете дали средата ви за изпълнение го предоставя. Използвайте new URL(input) за абсолютен адрес, а за относителна препратка подайте подходящ базов адрес чрез new URL(input, base). Ако подадената база е невалидна или разчитането е неуспешно, конструкторът хвърля TypeError. Промяната на обекта URL не предизвиква навигация.

origin е само за четене. При HTTP(S) съдържа схемата, името на хоста и порта, ако не е стандартният. Не включва данни за вход, път, заявка или фрагмент. Непрозрачен произход, както при адрес data:, се представя като низа "null", а не като стойността null. Два такива низа не доказват общ произход. Резултатът за file: зависи от реализацията.

pathname е пътят в текстов вид, без заявката и фрагмента. При HTTP(S) започва с /, а кореновият път е /. Процентно кодираните последователности като %20 не се декодират автоматично. При HTTP(S) можете да зададете нов път. Други схеми може да имат непрозрачен път без начална /.

search връща заявката с началния ?, без фрагмента и без декодиране на процентно кодираните последователности. Връща "", ако заявката липсва или е празна, включително при самостоятелен ?. Можете да зададете нова заявка със или без начален ?; задаването на "" я премахва.

Използвайте url.searchParams.get("q"), за да прочетете декодираната стойност на параметър. Промяна чрез searchParams обновява същия обект URL и може да промени записа на съществуващите стойности: интервал, записан като %20, може да стане +. Използвайте href, за да прочетете пълния адрес, включително фрагмента.

Примери

{
  const url = new URL("/catalog/./tea%20sets?q=green%20tea#reviews", "https://shop.example:443/");
  console.log(url.origin);
  console.log(url.pathname);
  console.log(url.search);
  console.log(url.searchParams.get("q"));

  url.searchParams.set("page", "2");
  console.log(url.href);
}

Резултат

https://shop.example
/catalog/tea%20sets
?q=green%20tea
green tea
https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews

Нормализирането премахва стандартния порт `443` и сегмента от пътя `.`. `search` запазва `%20`, `get("q")` връща стойност с интервал, а добавянето на `page=2` променя записа на този интервал в заявката на `+`.

Свързани уроци

  • JavaScript · Урок 38 · Напреднало · Версия: 4

Източници