NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #2058 most downloaded on npm
Generate massive amounts of fake contextual data
Latest stable
10.6.0
Last release 3 months ago
14 Aug 2026
Ships fairly regularly
a new release about every 2 months
Most releases are documented
notes for 45 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
88 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
fix(locale): exclude forbidden letter combinations from nl postcodes by @chatman-media in https://github.com/faker-js/faker/pull/3888
Full Changelog: https://github.com/faker-js/faker/compare/v10.5.0...v10.6.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
docs(image): remove deprecated urlLoremFlickr from module overview by @hiSandog in https://github.com/faker-js/faker/pull/3807
past and future by @xDivisionByZerox in https://github.com/faker-js/faker/pull/3783recent and soon by @ST-DDT in https://github.com/faker-js/faker/pull/3844Full Changelog: https://github.com/faker-js/faker/compare/v10.4.0...v10.5.0
recent and soon (#3844) (0bc038d)past and future (#3783) (237e7dc)feat(locale): add Norwegian (nb_NO) country definition by @TomSchrier in https://github.com/faker-js/faker/pull/3714
Full Changelog: https://github.com/faker-js/faker/compare/v10.3.0...v10.4.0
chore(deps): lock file maintenance by @renovate[bot] in https://github.com/faker-js/faker/pull/3689
sexType can return 'generic' by @ST-DDT in https://github.com/faker-js/faker/pull/3259Full Changelog: https://github.com/faker-js/faker/compare/v10.2.0...v10.3.0
sexType can return 'generic' (#3259) (0e099a1)feat(locale): add id_ID translation for animal, color, commerce, and word also add country to location id_ID translation. by @RizalAnas00 in https://g
Full Changelog: https://github.com/faker-js/faker/compare/v10.1.0...v10.2.0
refactor(image): mark loremflickr as deprecated, use only picsum photos in url() by @matthewmayer in https://github.com/faker-js/faker/pull/3610
Full Changelog: https://github.com/faker-js/faker/compare/v10.0.0...v10.1.0
refactor!: remove deprecations by @Shinigami92 in https://github.com/faker-js/faker/pull/3553
Full Changelog: https://github.com/faker-js/faker/compare/v9.9.0...v10.0.0
refactor!: remove deprecations by @Shinigami92 in https://github.com/faker-js/faker/pull/3553
Full Changelog: https://github.com/faker-js/faker/compare/v9.9.0...v10.0.0-beta.0
word: change default error strategy to 'fail' (#3560)
remove deprecations (#3553)
esm only (#3540)
word: change default error strategy to 'fail' (#3560) (93416f7)
chore(deps): update dependency ts-morph to v26 by @renovate in https://github.com/faker-js/faker/pull/3526
Full Changelog: https://github.com/faker-js/faker/compare/v9.8.0...v9.9.0
feat(locale): add country code for en_CA & fr_CA by @alixlahuec in https://github.com/faker-js/faker/pull/3476
Full Changelog: https://github.com/faker-js/faker/compare/v9.7.0...v9.8.0
feat(locale): Add bn_BD locale by @AbrarShahriar in https://github.com/faker-js/faker/pull/3439
Full Changelog: https://github.com/faker-js/faker/compare/v9.6.0...v9.7.0
refactor(internet): deprecate color method for removal by @ST-DDT in https://github.com/faker-js/faker/pull/3401
Full Changelog: https://github.com/faker-js/faker/compare/v9.5.1...v9.6.0
test: retry verify tag 3 times by @Shinigami92 in https://github.com/faker-js/faker/pull/3395
Full Changelog: https://github.com/faker-js/faker/compare/v9.5.0...v9.5.1
chore(deps): lock file maintenance by @renovate in https://github.com/faker-js/faker/pull/3377
Full Changelog: https://github.com/faker-js/faker/compare/v9.4.0...v9.5.0
chore: align coding style of deprecated.ts by @ST-DDT in https://github.com/faker-js/faker/pull/3312
cow data by @matthewmayer in https://github.com/faker-js/faker/pull/3326Full Changelog: https://github.com/faker-js/faker/compare/v9.3.0...v9.4.0
refactor(finance): deprecate maskedNumber for removal by @ST-DDT in https://github.com/faker-js/faker/pull/3201
helpers module by @yoshi2no in https://github.com/faker-js/faker/pull/3289Full Changelog: https://github.com/faker-js/faker/compare/v9.2.0...v9.3.0
infra: remove unused dependencies by @ST-DDT in https://github.com/faker-js/faker/pull/3227
Full Changelog: https://github.com/faker-js/faker/compare/v9.1.0...v9.2.0
chore(deps): update mcr.microsoft.com/devcontainers/typescript-node:22 docker digest to 79c4181 by @renovate in https://github.com/faker-js/faker/pull
continent method by @joscha in https://github.com/faker-js/faker/pull/3162Full Changelog: https://github.com/faker-js/faker/compare/v9.0.3...v9.1.0
continent method (#3162) (4056ab0)infra: update file structure for util/internal by @xDivisionByZerox in https://github.com/faker-js/faker/pull/3141
Full Changelog: https://github.com/faker-js/faker/compare/v9.0.2...v9.0.3
refactor(image): deprecate avatarLegacy for removal by @ST-DDT in https://github.com/faker-js/faker/pull/3109
Full Changelog: https://github.com/faker-js/faker/compare/v9.0.1...v9.0.2
infra: improve package.json fields by @Shinigami92 in https://github.com/faker-js/faker/pull/3096
Full Changelog: https://github.com/faker-js/faker/compare/v9.0.0...v9.0.1
docs: document breaking changes for #2476 into migration guide by @matthewmayer in https://github.com/faker-js/faker/pull/2935
v18v5v8 deprecationsmultiple by @pomali in https://github.com/faker-js/faker/pull/2563Full Changelog: https://github.com/faker-js/faker/compare/v8.4.1...v9.0.0
No noteworthy changes to 9.0.0-rc.1
For those upgrading from earlier versions, please refer to our Migration Guide for detailed instructions.
docs: replace deprecated moduleResolution by @MarlonPassos-git in https://github.com/faker-js/faker/pull/3018
Full Changelog: https://github.com/faker-js/faker/compare/v9.0.0-rc.0...v9.0.0-rc.1
test: remove usage of vitest.todo by @ST-DDT in https://github.com/faker-js/faker/pull/2960
Full Changelog: https://github.com/faker-js/faker/compare/v9.0.0-alpha.1...v9.0.0-rc.0
docs: document breaking changes for #2476 into migration guide by @matthewmayer in https://github.com/faker-js/faker/pull/2935
Full Changelog: https://github.com/faker-js/faker/compare/v9.0.0-alpha.0...v9.0.0-alpha.1
chore(deps): replace vitest v1 deprecations by @Shinigami92 in https://github.com/faker-js/faker/pull/2590
multiple by @pomali in https://github.com/faker-js/faker/pull/2563Full Changelog: https://github.com/faker-js/faker/compare/v8.4.1...v9.0.0-alpha.0
multiple (#2563)multiple (#2563) (2b15f2e)commerce: remove v8 deprecated commerce method (#2752) (8c80877)
company: remove v8 deprecated company methods (#2726) (19bcf88)
datatype: remove v8 deprecated datatype methods (#2694) (682a427)
finance: remove v8 deprecated finance methods (#2727) (a536a9d)
helpers: remove v8 deprecated helpers methods (#2729) (1169a05)
internet: remove v8 deprecated internet methods (#2699) (3024d9e)
location: remove default_country definitions (#2740) (a409b46)
location: remove v8 deprecated location methods (#2753) (6dee178)
number: remove v8 deprecated number parameter (#2738) (a672d27)
random: remove v8 deprecated image methods (#2697) (e99fba9)
docs: add awesome-faker link in guide -> community by @matthewmayer in https://github.com/faker-js/faker/pull/2625
Full Changelog: https://github.com/faker-js/faker/compare/v8.4.0...v8.4.1
refactor(helper): deprecate replaceSymbolWithNumber by @suyashgulati in https://github.com/faker-js/faker/pull/2557
fractionDigits in float by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1855Full Changelog: https://github.com/faker-js/faker/compare/v8.3.1...v8.4.0
fractionDigits in float (#1855) (41d8778)fix: remove @internal from module parent classes by @ST-DDT in https://github.com/faker-js/faker/pull/2548
@internal from module parent classes by @ST-DDT in https://github.com/faker-js/faker/pull/2548Full Changelog: https://github.com/faker-js/faker/compare/v8.3.0...v8.3.1
docs: fix deprecated text for internet.password by @rcbyr in https://github.com/faker-js/faker/pull/2486
⚠ WARNING: This version has compiler issues due to missing internal types.
Full Changelog: https://github.com/faker-js/faker/compare/v8.2.0...v8.3.0
infra: replace deprecated eslint config import by @ST-DDT in https://github.com/faker-js/faker/pull/2411
en_US, en_GB and en by @xDivisionByZerox in https://github.com/faker-js/faker/pull/2371Full Changelog: https://github.com/faker-js/faker/compare/v8.1.0...v8.2.0
docs: replace deprecated datatype.uuid() with string.uuid() by @saranatour1 in https://github.com/faker-js/faker/pull/2214
ja locale by @KeisukeYamashita in https://github.com/faker-js/faker/pull/2189format argument for phone.number by @xDivisionByZerox in https://github.com/faker-js/faker/pull/2229Full Changelog: https://github.com/faker-js/faker/compare/v8.0.2...v8.1.0
ja locale (#2189) (785a38a)test: vitest prefer-each by @Shinigami92 in https://github.com/faker-js/faker/pull/2144
Full Changelog: https://github.com/faker-js/faker/compare/v8.0.1...v8.0.2
This release only offers a cleanup of the docs and the README.md for npm
This release only offers a cleanup of the docs and the README.md for npm
Full Changelog: https://github.com/faker-js/faker/compare/v8.0.0...v8.0.1
Image providers are deprecated, please use the image module directly.
We are happy to announce that the stable release of v8. The v8 version will be the last version that supports NodeJS v14 which reached EOL on (2023-04-30). Future we won't also support TS 4.x in further major versions anymore (>= v9).
For a complete migration guide from v7 to v8 please checkout fakerjs.dev/guide/upgrading.
Biggest changes between v7 to v8:
@faker-js/faker, but there is a known bug #1791 so it is currently still recommended to import them from @faker-js/faker/locale/<locale>.faker.rawDefinitions, but this is not officially supported and can be changed at anytime.https://fakerjs.dev is now also fully updated. Please feel free to explore it.
nearbyGPSCoordinate returns number tuple by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1061latitude/longitude returns number by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1064zodiacSign() by @luciferreeves in https://github.com/faker-js/faker/pull/182git log output by @ST-DDT in https://github.com/faker-js/faker/pull/1539@see tags for deprecated methods by @matthewmayer in https://github.com/faker-js/faker/pull/1608allowLeadingZeros default to true by @import-brain in https://github.com/faker-js/faker/pull/1602allowLeadingZeros tests by @import-brain in https://github.com/faker-js/faker/pull/1638multiple method by @ST-DDT in https://github.com/faker-js/faker/pull/1545domainWord() by @schw4rzlicht in https://github.com/faker-js/faker/pull/1520arrayElements by @import-brain in https://github.com/faker-js/faker/pull/1772special to symbol by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1789pull_request_template by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1849json by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1852array by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1853state and state_abbr to cz by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1847objectEntry by @suyashgulati in https://github.com/faker-js/faker/pull/2123Full Changelog: https://github.com/faker-js/faker/compare/v7.6.0...v8.0.0
refactor(locale): add city_name to city_patterns by @xDivisionByZerox in https://github.com/faker-js/faker/pull/2104
objectEntry by @suyashgulati in https://github.com/faker-js/faker/pull/2123Full Changelog: https://github.com/faker-js/faker/compare/v8.0.0-beta.0...v8.0.0-beta.1
docs: mark method references in @deprecation messages by @ST-DDT in https://github.com/faker-js/faker/pull/1963
We are happy to announce that we are moving into the beta phase of v8. The v8 version is the last to support NodeJS v14 which reaches EOF tomorrow (2023-04-30) as well as TS 4.x. Future major versions (>= v9) won't support NodeJS v14 anymore and also official support for TS 4.x will be discontinued.
From now on, only small changes will be made; all the big things we wanted in v8 have already been implemented. This means we are now actively asking for your feedback, especially for the migration guide https://next.fakerjs.dev/guide/upgrading.html.
Biggest changes between v7 to v8:
@faker-js/faker, but there is a known bug #1791 so it is currently still recommended to import them from @faker-js/faker/locale/<locale>.faker.rawDefinitions, but this is not officially supported and can be changed at anytime.Please explore https://next.fakerjs.dev for more information.
Full Changelog: https://github.com/faker-js/faker/compare/v8.0.0-alpha.2...v8.0.0-beta.0
locale: add additional metadata properties (#2025) (a49aa0d)
locale: add hyphenated names to English locales (#1872) (17f0488)
helpers: remove default value from arrayElement (#2045) (0564446)
location: rename definition city to city_pattern (#2094) (8cd1965)
location: rename definition street to street_pattern (#2051) (3529ef7)
chore(random): deprecate random module by @ST-DDT in https://github.com/faker-js/faker/pull/1939
Full Changelog: https://github.com/faker-js/faker/compare/v8.0.0-alpha.1...v8.0.0-alpha.2
chore(test): skip console messages containing 'deprecated' by @matthewmayer in https://github.com/faker-js/faker/pull/1709
arrayElements by @import-brain in https://github.com/faker-js/faker/pull/1772special to symbol by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1789pull_request_template by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1849json by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1852array by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1853state and state_abbr to cz by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1847Full Changelog: https://github.com/faker-js/faker/compare/v8.0.0-alpha.0...v8.0.0-alpha.1
arrayElements (#1772) (b86638d)refactor!: cleanup deprecations by @Shinigami92 in https://github.com/faker-js/faker/pull/1440
nearbyGPSCoordinate returns number tuple by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1061latitude/longitude returns number by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1064zodiacSign() by @luciferreeves in https://github.com/faker-js/faker/pull/182git log output by @ST-DDT in https://github.com/faker-js/faker/pull/1539@see tags for deprecated methods by @matthewmayer in https://github.com/faker-js/faker/pull/1608allowLeadingZeros default to true by @import-brain in https://github.com/faker-js/faker/pull/1602allowLeadingZeros tests by @import-brain in https://github.com/faker-js/faker/pull/1638multiple method by @ST-DDT in https://github.com/faker-js/faker/pull/1545domainWord() by @schw4rzlicht in https://github.com/faker-js/faker/pull/1520Full Changelog: https://github.com/faker-js/faker/compare/v7.6.0...v8.0.0-alpha.0
latitude/longitude returns number (#1064)nearbyGPSCoordinate returns number tuple (#1061)allowLeadingZeros default to true (#1602)multiple method (#1545) (f06126a)latitude/longitude returns number (#1064) (dac6be3)nearbyGPSCoordinate returns number tuple (#1061) (4765336)zodiacSign() (#182) (7e00d17)git log output (#1539) (99b6fb2)allowLeadingZeros default to true (#1602) (c4b7ce8)domainWord() (#1520) (cf764b9)allowLeadingZeros tests (#1638) (97dbfa1)chore: mark mersenne as deprecated (internal) by @ST-DDT in https://github.com/faker-js/faker/pull/1429
@since tags to all methods by @matthewmayer in https://github.com/faker-js/faker/pull/1337usage page in guides by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1366Indonesian by @fzn0x in https://github.com/faker-js/faker/pull/1401Full Changelog: https://github.com/faker-js/faker/compare/v7.5.0...v7.6.0
Indonesian (#1401) (ec0181e)ci: allow breaking change commits by @Shinigami92 in https://github.com/faker-js/faker/pull/1255
datatype.hexadecimal signature change by @import-brain in https://github.com/faker-js/faker/pull/1238@see by @ST-DDT in https://github.com/faker-js/faker/pull/1269@see tags by @ST-DDT in https://github.com/faker-js/faker/pull/1270Full Changelog: https://github.com/faker-js/faker/compare/v7.4.0...v7.5.0
refactor(company.name): deprecate format parameter by @Minozzzi in https://github.com/faker-js/faker/pull/1212
unbound-method warnings by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1128helpers by @xDivisionByZerox in https://github.com/faker-js/faker/pull/1161format parameter by @Minozzzi in https://github.com/faker-js/faker/pull/1212Full Changelog: https://github.com/faker-js/faker/compare/v7.3.0...v7.4.0
chore: deprecate cityPrefix and citySuffix by @ST-DDT in https://github.com/faker-js/faker/pull/1041
Webpack v4 should now be supported 🚀
hacker.abbreviation() in the en locale by @import-brain in https://github.com/faker-js/faker/pull/1086Full Changelog: https://github.com/faker-js/faker/compare/v7.2.0...v7.3.0
We removed the last parameter for image.imageUrl and always generate https URLs
We removed the last parameter for image.imageUrl and always generate https URLs
Full Changelog: https://github.com/faker-js/faker/compare/v7.1.0...v7.2.0
image.imageUrl and always generate https urls⚠ WARNING: This version has compiler issues when using webpack!
⚠ WARNING: This version has compiler issues when using webpack!
Full Changelog: https://github.com/faker-js/faker/compare/v7.0.1...v7.1.0
fix: revert type exports for module NodeNext, Node16 (#979) by @Shinigami92 in https://github.com/faker-js/faker/pull/989
Full Changelog: https://github.com/faker-js/faker/compare/v7.0.0...v7.0.1
refactor!: remove deprecations by @Shinigami92 in https://github.com/faker-js/faker/pull/916
Full Changelog: https://github.com/faker-js/faker/compare/v6.3.1...v7.0.0
fix: replace deprecated arrayElement calls by @Shinigami92 in https://github.com/faker-js/faker/pull/903
Full Changelog: https://github.com/faker-js/faker/compare/v6.3.0...v6.3.1
One column per quarter.