|
|
/** * negotiator * Copyright(c) 2012 Isaac Z. Schlueter * Copyright(c) 2014 Federico Romero * Copyright(c) 2014-2015 Douglas Christopher Wilson * MIT Licensed */
'use strict';
/** * Module exports. * @public */
module.exports = preferredLanguages; module.exports.preferredLanguages = preferredLanguages;
/** * Module variables. * @private */
var simpleLanguageRegExp = /^\s*([^\s\-;]+)(?:-([^\s;]+))?\s*(?:;(.*))?$/;
/** * Parse the Accept-Language header. * @private */
function parseAcceptLanguage(accept) { var accepts = accept.split(',');
for (var i = 0, j = 0; i < accepts.length; i++) { var language = parseLanguage(accepts[i].trim(), i);
if (language) { accepts[j++] = language; } }
// trim accepts
accepts.length = j;
return accepts; }
/** * Parse a language from the Accept-Language header. * @private */
function parseLanguage(str, i) { var match = simpleLanguageRegExp.exec(str); if (!match) return null;
var prefix = match[1] var suffix = match[2] var full = prefix
if (suffix) full += "-" + suffix;
var q = 1; if (match[3]) { var params = match[3].split(';') for (var j = 0; j < params.length; j++) { var p = params[j].split('='); if (p[0] === 'q') q = parseFloat(p[1]); } }
return { prefix: prefix, suffix: suffix, q: q, i: i, full: full }; }
/** * Get the priority of a language. * @private */
function getLanguagePriority(language, accepted, index) { var priority = {o: -1, q: 0, s: 0};
for (var i = 0; i < accepted.length; i++) { var spec = specify(language, accepted[i], index);
if (spec && (priority.s - spec.s || priority.q - spec.q || priority.o - spec.o) < 0) { priority = spec; } }
return priority; }
/** * Get the specificity of the language. * @private */
function specify(language, spec, index) { var p = parseLanguage(language) if (!p) return null; var s = 0; if(spec.full.toLowerCase() === p.full.toLowerCase()){ s |= 4; } else if (spec.prefix.toLowerCase() === p.full.toLowerCase()) { s |= 2; } else if (spec.full.toLowerCase() === p.prefix.toLowerCase()) { s |= 1; } else if (spec.full !== '*' ) { return null }
return { i: index, o: spec.i, q: spec.q, s: s } };
/** * Get the preferred languages from an Accept-Language header. * @public */
function preferredLanguages(accept, provided) { // RFC 2616 sec 14.4: no header = *
var accepts = parseAcceptLanguage(accept === undefined ? '*' : accept || '');
if (!provided) { // sorted list of all languages
return accepts .filter(isQuality) .sort(compareSpecs) .map(getFullLanguage); }
var priorities = provided.map(function getPriority(type, index) { return getLanguagePriority(type, accepts, index); });
// sorted list of accepted languages
return priorities.filter(isQuality).sort(compareSpecs).map(function getLanguage(priority) { return provided[priorities.indexOf(priority)]; }); }
/** * Compare two specs. * @private */
function compareSpecs(a, b) { return (b.q - a.q) || (b.s - a.s) || (a.o - b.o) || (a.i - b.i) || 0; }
/** * Get full language string. * @private */
function getFullLanguage(spec) { return spec.full; }
/** * Check if a spec has any quality. * @private */
function isQuality(spec) { return spec.q > 0; }
|