js-path-trie/README-ru.md

@e22m4u/js-path-trie

English | Русский

Маршрутизатор для Node.js на основе префиксного дерева (trie).

• Использует path-to-regexp синтаксис.
• Поддерживает параметры маршрута.

Установка

npm install @e22m4u/js-path-trie

Модуль поддерживает ESM и CommonJS стандарты.

ESM

import {PathTrie} from '@e22m4u/js-path-trie';

CommonJS

const {PathTrie} = require('@e22m4u/js-path-trie');

Overview

Класс PathTrie имеет следующие методы:

• add(pathTemplate: string, value: unknown) - добавить значение к новому маршруту
• match(path: string) - поиск значения по заданному маршруту

Пример:

import {PathTrie} from '@e22m4u/js-path-trie';

const trie = new PathTrie();

// добавление маршрутов выполняется
// методом "add", который принимает
// шаблон маршрута и его значение
trie.add('/foo/bar', yourValue1);
trie.add('/foo/:p1/bar/:p2', yourValue2);

// для поиска значения используется
// метод "match", который возвращает
// значение маршрута и его параметры
trie.match('/foo/bar');
// {
//   value: yourValue1,
//   params: {}
// }

// если маршрут имеет параметры,
// то их значения вернуться
// в результате поиска
trie.match('/foo/10/bar/20');
// {
//   value: yourValue2,
//   params: {p1: 10, p2: 20}
// }

// если маршрут не найден,
// то возвращается "undefined"
trie.match('/foo/bar/baz');
// undefined

Отладка

Установка переменной DEBUG включает вывод логов.

DEBUG=jsPathTrie* npm run test

Тестирование

npm run test

Лицензия

MIT