npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@unly/universal-language-detector

v2.0.3

Published

Language detector that works universally (browser + server) - Meant to be used with a universal framework, such as Next.js

Downloads

6,311

Readme

Maintainability Test Coverage Known Vulnerabilities

Universal Language Detector

Language detector that works universally (browser + server)

  • On the server, will rely on "cookies > accept-language header"
  • On the browser, will rely on "cookies > navigator settings"

Meant to be used with a universal framework, such as Next.js

Note that this lib helps resolving the language (fr, en, es, etc.), not the locale (fr-FR, en-US, etc.)

It is not out of scope though, PR are welcome to support universal locale detection.



Demo

Live demo with the Next.js example

Getting started

yarn install @unly/universal-language-detector

Use:

import universalLanguageDetect from '@unly/universal-language-detector';

OR

import { universalLanguageDetect } from '@unly/universal-language-detector';

Examples

See our example featuring the Next.js framework


API

Extensive API documentation can be found in the source code documentation

Only the most useful API methods are documented here, the other aren't meant to be used, even though they may be

universalLanguageDetect

Detects the language used, universally.

Parameters:

  • supportedLanguages: string[];
  • fallbackLanguage: string;
  • acceptLanguageHeader?: string | undefined;
  • serverCookies?: object | undefined;
  • errorHandler?: ErrorHandler | undefined;

Example:

const lang = universalLanguageDetect({
  supportedLanguages: SUPPORTED_LANGUAGES, // Whitelist of supported languages, will be used to filter out languages that aren't supported
  fallbackLanguage: FALLBACK_LANG, // Fallback language in case the user's language cannot be resolved
  acceptLanguageHeader: get(req, 'headers.accept-language'), // Optional - Accept-language header will be used when resolving the language on the server side
  serverCookies: cookies, // Optional - Cookie "i18next" takes precedence over navigator configuration (ex: "i18next: fr"), will only be used on the server side
  errorHandler: (error) => { // Optional - Use you own logger here, Sentry, etc.
    console.log('Custom error handler:');
    console.error(error);
  },
});

Contributing

We gladly accept PRs, but please open an issue first so we can discuss it beforehand.

Working locally

yarn start # Shortcut - Runs linter + build + tests in concurrent mode (watch mode)

OR run each process separately for finer control

yarn lint
yarn build
yarn test

Test

yarn test # Run all tests, interactive and watch mode
yarn test:once
yarn test:coverage

Versions

SemVer

We use Semantic Versioning for this project: https://semver.org/. (vMAJOR.MINOR.PATCH: v1.0.1)

  • Major version: Must be changed when Breaking Changes are made (public API isn't backward compatible).
    • A function has been renamed/removed from the public API
    • Something has changed that will cause the app to behave differently with the same configuration
  • Minor version: Must be changed when a new feature is added or updated (without breaking change nor behavioral change)
  • Patch version: Must be changed when any change is made that isn't either Major nor Minor. (Misc, doc, etc.)

Releasing and publishing

yarn releaseAndPublish # Shortcut - Will prompt for bump version, commit, create git tag, push commit/tag and publish to NPM

yarn release # Will prompt for bump version, commit, create git tag, push commit/tag
npm publish # Will publish to NPM

Don't forget we are using SemVer, please follow our SemVer rules.

Pro hint: use beta tag if you're in a work-in-progress (or unsure) to avoid releasing WIP versions that looks legit


Changelog

Our API change (including breaking changes and "how to migrate") are documented in the Changelog.

See changelog


License

MIT


This project was generated using https://github.com/UnlyEd/boilerplate-generator/tree/master/templates/typescript-OSS

Vulnerability disclosure

See our policy.


Contributors and maintainers

This project is being maintained by:


[ABOUT UNLY]

Unly is a socially responsible company, fighting inequality and facilitating access to higher education. Unly is committed to making education more inclusive, through responsible funding for students.

We provide technological solutions to help students find the necessary funding for their studies.

We proudly participate in many TechForGood initiatives. To support and learn more about our actions to make education accessible, visit :

Tech tips and tricks from our CTO on our Medium page!

#TECHFORGOOD #EDUCATIONFORALL