req.acceptsLanguages()
Return whether this request (req) advertises that it understands any of the specified language(s), and if so, which one.
If more than one of the languages passed in to this method are considered acceptable, then the first one will be returned. If none of the languages are considered acceptable, this returns
false. (By languages, we mean natural languages, like English or Japanese, not programming languages.)
Usage
req.acceptsLanguages(language);
Or:
req.acceptsLanguages(language1, language2, …);
Details
This method can be useful as a complement to built-in internationalization and localization, which allows for automatically serving different content to different locales based on the request.
Example
If a request is sent with "Accept-Language: da, en, en-gb, en-us;":
req.acceptsLanguages('en');
// -> 'en'
req.acceptsLanguages('es');
// -> false
req.acceptsLanguages('en-us', 'en', 'en-gb');
// -> 'en-us'
req.acceptsLanguages('en-gb', 'en', 'en-us');
// -> 'en-gb'
req.acceptsLanguages('es', 'fr');
// -> false
Notes
- You can expect the "Accept-Language" header to exist in most requests that originate in web browsers (see RFC-2616).
- Browsers send the "Accept-Language" header automatically, based on the user's language settings.
- See the
acceptspackage for the finer details of the header-parsing algorithm used in Sails/Express.
For a better experience on sailsjs.com, update your browser.
Reference
- Application
- Blueprint API
- Command-line interface
-
Configuration
- sails.config.*
- sails.config.blueprints
- sails.config.bootstrap()
- sails.config.custom
- sails.config.datastores
- sails.config.globals
- sails.config.http
- sails.config.i18n
- sails.config.log
- sails.config.models
- sails.config.policies
- sails.config.routes
- sails.config.security
- sails.config.session
- sails.config.sockets
- sails.config.views
-
Request (`req`)
- req._startTime
- req.body
- req.cookies
- req.fresh
- req.headers
- req.hostname
- req.ip
- req.ips
- req.isSocket
- req.method
- req.options
- req.originalUrl
- req.params
- req.path
- req.protocol
- req.query
- req.secure
- req.signedCookies
- req.socket
- req.subdomains
- req.url
- req.wantsJSON
- req.xhr
- req.accepts()
- req.acceptsCharsets()
- req.acceptsLanguages()
- req.allParams()
- req.file()
- req.get()
- req.is()
- req.param()
- req.setLocale()
- req.setTimeout()
- req.host
- Response (`res`)
- Waterline (ORM)
- WebSockets
Built with Love
The Sails framework is built by a web & mobile shop in Austin, TX, with the help of our contributors. We created Sails in 2012 to assist us on Node.js projects. Naturally we open-sourced it. We hope it makes your life a little bit easier!
© 2012-2023 The Sails Company.
The Sails framework is free and open-source under the MIT License.
Illustrations by Edamame.