Gathering detailed insights and metrics for y18n
Gathering detailed insights and metrics for y18n
Installations
npm install y18nDeveloper Guide
BETA
Typescript
No
Module System
ESM
Min. Node Version
>=10
Node Version
14.16.0
NPM Version
6.14.11
Releases
11
Languages
2
JavaScript
TypeScript
JavaScript (59.97%)
TypeScript (40.03%)
Developer
yargs
Download Statistics
Total Downloads
0
Last Day
0
Last Week
0
Last Month
0
Last Year
0
GitHub Statistics
ISC License
152 Stars
113 Commits
49 Forks
16 Watchers
84 Branches
20 Contributors
Updated on Jun 17, 2025
Maintainers
3
Package Meta Information
Latest Version
5.0.8
Package Id
y18n@5.0.8
Size
6.01 kB
NPM Version
6.14.11
Node Version
14.16.0
Published on
Apr 07, 2021
Total Downloads
Cumulative downloads
Total Downloads
NaN
Last Day
0%
NaN
Compared to previous day
Last Week
0%
NaN
Compared to previous week
Last Month
0%
NaN
Compared to previous month
Last Year
0%
NaN
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
y18n
The bare-bones internationalization library used by yargs.
Inspired by i18n.
Examples
simple string translation:
1const __ = require('y18n')().__; 2 3console.log(__('my awesome string %s', 'foo'));
output:
my awesome string foo
using tagged template literals
1const __ = require('y18n')().__; 2 3const str = 'foo'; 4 5console.log(__`my awesome string ${str}`);
output:
my awesome string foo
pluralization support:
1const __n = require('y18n')().__n; 2 3console.log(__n('one fish %s', '%d fishes %s', 2, 'foo'));
output:
2 fishes foo
Deno Example
As of v5 y18n supports Deno:
1import y18n from "https://deno.land/x/y18n/deno.ts"; 2 3const __ = y18n({ 4 locale: 'pirate', 5 directory: './test/locales' 6}).__ 7 8console.info(__`Hi, ${'Ben'} ${'Coe'}!`)
You will need to run with --allow-read to load alternative locales.
JSON Language Files
The JSON language files should be stored in a ./locales folder.
File names correspond to locales, e.g., en.json, pirate.json.
When strings are observed for the first time they will be added to the JSON file corresponding to the current locale.
Methods
require('y18n')(config)
Create an instance of y18n with the config provided, options include:
directory: the locale directory, default./locales.updateFiles: should newly observed strings be updated in file, defaulttrue.locale: what locale should be used.fallbackToLanguage: should fallback to a language-only file (e.g.en.json) be allowed if a file matching the locale does not exist (e.g.en_US.json), defaulttrue.
y18n.__(str, arg, arg, arg)
Print a localized string, %s will be replaced with args.
This function can also be used as a tag for a template literal. You can use it
like this: __`hello ${'world'}`. This will be equivalent to
__('hello %s', 'world').
y18n.__n(singularString, pluralString, count, arg, arg, arg)
Print a localized string with appropriate pluralization. If %d is provided
in the string, the count will replace this placeholder.
y18n.setLocale(str)
Set the current locale being used.
y18n.getLocale()
What locale is currently being used?
y18n.updateLocale(obj)
Update the current locale with the key value pairs in obj.
Supported Node.js Versions
Libraries in this ecosystem make a best effort to track Node.js' release schedule. Here's a post on why we think this is important.
License
ISC
High
7.3/10
Summary
Prototype Pollution in y18n
Affected Versions
>= 5.0.0, < 5.0.5
Patched Versions
5.0.5
High
7.3/10
Summary
Prototype Pollution in y18n
Affected Versions
= 4.0.0
Patched Versions
4.0.1
High
7.3/10
Summary
Prototype Pollution in y18n
Affected Versions
< 3.2.2
Patched Versions
3.2.2
Reason
no binaries found in the repo
Reason
no dangerous workflow patterns detected
Reason
0 existing vulnerabilities detected
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: ISC License: LICENSE:0
Reason
Found 6/16 approved changesets -- score normalized to 3
Reason
0 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 0
Reason
dependency not pinned by hash detected -- score normalized to 0
Details
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:46: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yaml:61: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/ci.yaml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-please.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/release-please.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/release-please.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/release-please.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/y18n/release-please.yml/master?enable=pin
- Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:60
- Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:23
- Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:41
- Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:51
- Warn: npmCommand not pinned by hash: .github/workflows/release-please.yml:21
- Warn: npmCommand not pinned by hash: .github/workflows/release-please.yml:40
- Info: 0 out of 13 GitHub-owned GitHubAction dependencies pinned
- Info: 0 out of 2 third-party GitHubAction dependencies pinned
- Info: 0 out of 6 npmCommand dependencies pinned
Reason
detected GitHub workflow tokens with excessive permissions
Details
- Warn: no topLevel permission defined: .github/workflows/ci.yaml:1
- Warn: no topLevel permission defined: .github/workflows/release-please.yml:1
- Info: no jobLevel write permissions found
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
- Warn: 0 commits out of 23 are checked with a SAST tool
Score
4.1
/10
Last Scanned on 2025-06-30
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More