Node.js · Conceptos
Expresiones de ruta
Una expresión de ruta identifica directivas dentro de un árbol. La usan
find, findAll
y at de Directive, y las claves de las reglas de lint. Los ejemplos usan este documento:
server {
route /home
route GET /api/user
route POST /api/user
} root.find("/server/route(/home)"); // route /home
root.findAll("/server/route(* /api/user)"); // GET y POST
root.at("/server/route(GET /api/user)"); // la directiva
root.at("/server/route(GET /api/user)[2]"); // '/api/user' Segmentos: /
/ (o el texto vacío) es la directiva de partida.
Cada /nombre baja un nivel hacia los hijos con
ese nombre.
Escape: \
\ hace que el carácter siguiente (/, (, ) o *) se lea literalmente.
Sirve para directivas cuyo nombre incluye /.
// una directiva cuyo nombre es "/user"
root.find("/server/\\/user"); Comodines: *
* reemplaza cualquier nombre o un único argumento.
También funciona como prefijo, sufijo o trozo (pre*, *suf, pre*mid*suf).
root.findAll("/server/*"); // cualquier hija de server
root.findAll("/server/route*"); // prefijo
root.findAll("/server/*Handler"); // sufijo
root.findAll("/server/route(GET /api/*)"); // patrón en un argumento Argumentos: ( )
Un grupo ( ) solo coincide si la cantidad de argumentos
es igual a la de patrones separados por espacio, y cada uno coincide en su posición.
Con tres comodines coincide solo por cantidad. Sin grupo, los argumentos no se
miran.
route(GET /home) // exactamente 2 argumentos, GET y /home
route(* * *) // exactamente 3 argumentos, cualquiera
route() // sin argumentos
route // no mira los argumentos Filtro por descendiente: { }
{ruta} deja pasar solo las directivas que
tienen un descendiente que coincide con la ruta. El resultado sigue siendo la
directiva filtrada, no el descendiente.
// route que tenga un descendiente /auth(on); devuelve el route
root.findAll("/server/route{/auth(on)}"); AND y OR
Apilar grupos ( ) o
{ } en un segmento es un AND: todos deben
coincidir. | es un OR, entre valores de un argumento,
entre rutas dentro de un filtro, o entre rutas completas (en ese caso los resultados
se concatenan).
// AND: apilar grupos
root.findAll("/server/route(GET *)(* /api/*)");
root.findAll("/server/route{/auth}{/respond}");
// OR: dentro de un valor, de un filtro o entre rutas completas
root.findAll("/server/route(GET|POST /api/user)");
root.findAll("/server/route{/auth(on)|/auth(strict)}");
root.findAll("/server/route|/server/proxy"); Argumento: [N]
Un sufijo [N] selecciona el argumento en la posición
N (desde 1). at lo devuelve; en las reglas de lint restringe
ese argumento.