Cabeceras HTTP Pillars.js reference

Pillars.js parsea y deja accesibles de una forma directa y homogénea las cabeceras HTTP:

  • Accept, contenido en req.headers['accept'] de Node.js, especifica qué tipo de contenidos son aceptables para la respueta, su valor es un string similar a: "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8". Pillars.js setea en gw.accepts.types un array que contiene esta información, de forma ordenada y homogeneizada.
// gw.accepts.types
[
{
value: "text/html",
q: 100
},
{
value: "application/xhtml+xml",
q: 100
},
{
value: "image/webp",
q: 100
},
{
value: "application/xml",
q: 90
},
{
value: "*/*",
q: 80
}
]
  • Accept-Encoding. Determina la compresión que se espera de la respuesta. Los valores comunes son gzip, deflate o sin compresión. La propiedad req.headers['accept-encoding'] de Node.js contiene un string con todos los valores, junto con la calidad, siguiendo la norma RFC referida a los parámetros de calidad. Un ejemplo de este string: "gzip, deflate, sdch". Pillars.js transforma este string en gw.accepts.encodings, un array ordenado con los parámetros de calidad homogeneizados. Por otro lado, la codificación usada en la respueta se setea en gw.encoding.
// gw.accepts.encodings
[
{
value: "gzip",
q: 100
},
{
value: "deflate",
q: 100
},
{
value: "sdch",
q: 100
}
]
// gw.encoding
"gzip"
  • Accept-Language. La propiedad req.headers["accept-language"] de Node.js contiene un string con algo similar a "en,es;q=0.8" que sigue la norma RFC de Accepts-Language y la norma RFC referida a los parámetros calidad. Pillars.js transforma este string en algo accesible y directo, seteando en la propiedad gw.accepts.languages un array ordenado y homogeneizado, por lo que en gw.accepts.languages[0].value tenemos el idioma aceptado para la respuesta. Además, y relacionado con esta propiedad, en gw.language tenemos el idioma que va a usar el servidor para la respuesta.
// gw.accepts.languages
[
{
value: "en",
q: 100
},
{
value: "es",
q: 80
}
]
// gw.language
"en"
  • User-Agent. Información relativa al cliente disponible en gw.ua, disponible de una forma directa.
// gw.ua 
{
mobile: false,
os: 'Windows NT 6.1; WOW64',
engine: 'Blink',
browser: 'Chrome'
}
  • WWW-Authenticate. Cabecera que emite un diálogo en cliente solicitando usuario y contraseña. Esta cabecera se emite al cliente mediante el método gw.authenticate(). Los datos del usuario estarán seteados en gw.auth.
// gw.auth
{
user: 'UserName',
pass: 'PassUser'
}
Volver arriba