URLPattern: метод test()

Метод test() интерфейса URLPattern принимает URL или объект с частями URL и возвращает булево значение, указывающее, соответствует ли переданный ввод текущему шаблону.

input

URL или части URL для проверки соответствия. Это может быть строка или объект, предоставляющий отдельные части URL. Члены объекта могут быть любыми из protocol, username, password, hostname, port, pathname, search, hash, или baseURL. Пропущенные части в объекте будут обрабатываться как пустые строки. Если ввод не может быть распарсен или указан относительный URL без базового, метод вернёт null.

baseURL Необязательно

Строка, представляющая базовый URL, используемый в тех случаях, когда input является относительным URL. Если не указано, по умолчанию используется undefined. Если этот параметр не может быть распарсен, метод вернет false.

Значение типа boolean.

В этом примере показано, как использовать метод test() для проверки соответствия URL шаблону. Пример выводит результат вызовов test() в консоль.

const pattern = new URLPattern("http{s}?://*.example.com/books/:id");

// Absolute URL strings
console.log(pattern.test("https://store.example.com/books/123")); // true
console.log(pattern.test("https://example.com/books/123")); // false

// Relative URL strings
console.log(pattern.test("/books/123", "http://store.example.com")); // true
console.log(pattern.test("/books/123", "data:text/plain,hello world!")); // false
console.log(pattern.test("/books/123")); // false

// Structured objects
console.log(
  pattern.test({
    pathname: "/books/123",
    baseURL: "http://store.example.com",
  }),
); // true
console.log(
  pattern.test({
    protocol: "https",
    hostname: "store.example.com",
    pathname: "/books/123",
  }),
); // true
console.log(
  pattern.test({
    protocol: "file",
    hostname: "store.example.com",
    pathname: "/books/123",
  }),
); // false

• Полифилл URLPattern доступен на GitHub