URLPattern

URLPattern зіставляє повні URL або окремі компоненти URL.

const users = new URLPattern({ pathname: "/users/:id" });

users.test({ pathname: "/users/42" }); // true
users.exec({ pathname: "/users/42" }).pathname.groups.id; // "42"

Конструктор приймає рядок шаблону з необов’язковим базовим URL або словник із protocol, username, password, hostname, port, pathname, search, hash і baseURL. Параметр ignoreCase вмикає зіставлення без урахування регістру.

Синтаксис шаблонів

const api = new URLPattern("https://*.example.com/api/:resource");
api.exec("https://v2.example.com/api/widgets")
  .pathname.groups.resource; // "widgets"

const numeric = new URLPattern({ pathname: "/items/:id(\\d+)" });
numeric.test({ pathname: "/items/123" }); // true

const relative = new URLPattern("/items/:id", "https://example.com/");
relative.test("https://example.com/items/7"); // true

test() повертає логічне значення. exec() повертає null або результат із вхідними даними та групами захоплення кожного компонента. Атрибути компонентів лише для читання надають скомпільований шаблон, а hasRegExpGroups вказує на наявність явних груп регулярних виразів.

Reference

Status: Full · Not measured · since 1.1.0

Exports