Приоритет совпадений

В библиотеке Universal Router при определении маршрутов ключевую роль играет механизм выбора подходящего маршрута для конкретного URL. Приоритет совпадений определяет, какой маршрут будет вызван, если несколько маршрутов потенциально соответствуют текущему пути. Понимание этого механизма критично для построения сложных маршрутизируемых приложений на JavaScript.

Порядок маршрутов и их значимость

Universal Router использует массив объектов маршрутов. Каждый объект может содержать следующие ключевые свойства:

  • path — строка с шаблоном пути (/users/:id), поддерживающая параметры и регулярные выражения.
  • action — функция, выполняемая при совпадении маршрута.
  • children — вложенные маршруты для иерархической структуры.
  • name и meta — дополнительные свойства для идентификации и хранения информации.

Маршруты обрабатываются в порядке, в котором они заданы в массиве. Если несколько маршрутов совпадают с URL, первый подходящий маршрут получает приоритет. Это правило является базовым принципом работы маршрутизатора.

const routes = [
  { path: '/users/:id', action: () => 'User profile' },
  { path: '/users/settings', action: () => 'User settings' }
];

const router = new UniversalRouter(routes);
router.resolve('/users/settings'); // вернёт 'User profile', если порядок маршрутов не изменён

В приведённом примере маршрут /users/:id имеет более общий шаблон, поэтому он срабатывает раньше, чем более конкретный маршрут /users/settings. Это демонстрирует, что порядок определения маршрутов напрямую влияет на приоритет совпадений.

Конкретность маршрута и wildcard

Universal Router определяет приоритет маршрутов не только по порядку, но и с учётом конкретности пути.

  • Статические сегменты (/users/settings) имеют более высокий приоритет, чем динамические параметры (/users/:id).
  • Wildcard (*) всегда находится на самом низком уровне приоритетов, так как он предназначен для ловли всех не совпавших маршрутов.
const routes = [
  { path: '/users/settings', action: () => 'User settings' },
  { path: '/users/:id', action: () => 'User profile' },
  { path: '*', action: () => 'Not found' }
];

const router = new UniversalRouter(routes);
router.resolve('/users/123'); // 'User profile'
router.resolve('/users/settings'); // 'User settings'
router.resolve('/unknown/path'); // 'Not found'

Такое распределение приоритетов позволяет безопасно комбинировать конкретные маршруты и универсальные обработчики ошибок.

Вложенные маршруты и рекурсивный поиск

Для сложных приложений маршруты часто строятся иерархически через свойство children. При этом Universal Router использует рекурсивный алгоритм поиска:

  1. Проверяются все маршруты верхнего уровня.
  2. Если путь совпадает частично и есть вложенные маршруты, проверяются children.
  3. Приоритет среди дочерних маршрутов определяется так же: сначала более конкретные пути, затем динамические параметры.
const routes = [
  {
    path: '/users',
    children: [
      { path: 'settings', action: () => 'User settings' },
      { path: ':id', action: () => 'User profile' }
    ]
  }
];

const router = new UniversalRouter(routes);
router.resolve('/users/42'); // 'User profile'
router.resolve('/users/settings'); // 'User settings'

Важно, что при использовании вложенных маршрутов путь для дочернего маршрута считается относительно родителя. Это обеспечивает корректную обработку приоритетов даже в глубоко вложенных структурах.

Совпадение по регулярным выражениям

Universal Router поддерживает использование регулярных выражений в пути, что позволяет задать более точные или универсальные правила сопоставления.

const routes = [
  { path: '/files/:filename([a-z]+\\.txt)', action: ({ params }) => `Text file: ${params.filename}` },
  { path: '/files/:filename', action: ({ params }) => `Other file: ${params.filename}` }
];

const router = new UniversalRouter(routes);
router.resolve('/files/readme.txt'); // 'Text file: readme.txt'
router.resolve('/files/IMAGE.JPG'); // 'Other file: IMAGE.JPG'

Регулярные выражения повышают конкретность маршрута и, соответственно, его приоритет при совпадении. Универсальный маршрут с более свободным шаблоном срабатывает только тогда, когда более специфические варианты не подходят.

Советы по управлению приоритетами

  • Ставить более конкретные маршруты выше общих: статические пути перед динамическими и wildcard.
  • Использовать вложенные маршруты для организации структуры: это позволяет сохранять читаемость и управлять приоритетами на разных уровнях.
  • Регулярные выражения для уточнения параметров: помогают отделить особые случаи от общих.
  • Wildcard (*) в конце списка: служит ловушкой для необработанных URL.

Практическое правило для больших приложений

В крупных приложениях рекомендуется сначала группировать маршруты по функциональным блокам, затем внутри блоков располагать:

  1. Статические маршруты
  2. Динамические параметры
  3. Wildcard

Такой подход обеспечивает предсказуемость и устраняет конфликты при совпадении URL.

Резюме по приоритетам совпадений

  • Порядок в массиве важен — первый совпавший маршрут срабатывает первым.
  • Конкретность пути важнее, чем общий шаблон или параметр.
  • Вложенные маршруты проверяются рекурсивно, сохраняя приоритет внутри родительского маршрута.
  • Регулярные выражения повышают точность совпадения и влияют на приоритет.
  • Wildcard (*) должен использоваться как запасной маршрут для непойманных URL.

Такое понимание принципов приоритета совпадений обеспечивает надежную и предсказуемую маршрутизацию в приложениях на JavaScript с использованием Universal Router.

Оглавление