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.