NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #2058 most downloaded on npm
Generate massive amounts of fake contextual data
Last release 1 months ago
14 Aug 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 14 of 14 stable releases
73 versions withdrawn
withdrawn after publishing
5 years old
88 releases · first in 2022
One column per quarter.
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
> v7 will contain many breaking changes like removal of all current deprecated functions.
arrayElement(s) to helpers
objectKey and objectValue, deprecate objectElementseed() function, please use this return value instead of faker.seedValuegit.commitEntryThis will be the last
v6version and we will now start withv7. Therefore this is the last version that supports Nodev12. The next iteration will require at least Nodev14.6.v7will contain many breaking changes like removal of all current deprecated functions.
Full Changelog: https://github.com/faker-js/faker/compare/v6.2.0...v6.3.0
fix: dont log deprecations on startup by @Shinigami92 in https://github.com/faker-js/faker/pull/857
lorem.paragraphs() now use \n as separator by defaultfinance.pin, database.mongodbObjectId, phone.imei, and internet.emoji\n as default separator for lorem.paragraphs() by @ST-DDT in https://github.com/faker-js/faker/pull/783Full Changelog: https://github.com/faker-js/faker/compare/v6.1.2...v6.2.0
chore: deprecate name.title() in favor of name.jobTitle() by @ST-DDT in https://github.com/faker-js/faker/pull/766
FakerError instead of just Error https://github.com/faker-js/faker/pull/718datatype.number changed in behavior https://github.com/faker-js/faker/pull/664hexaDecimal to hexadecimal https://github.com/faker-js/faker/pull/764Full Changelog: https://github.com/faker-js/faker/compare/v6.1.1...v6.1.2
release: 6.1.1 by @Shinigami92 in https://github.com/faker-js/faker/pull/716
Full Changelog: https://github.com/faker-js/faker/compare/v6.1.0...v6.1.1
chore: deprecate helpers.*Card methods by @sprohaszka in https://github.com/faker-js/faker/pull/543
fake for internal calls by @pkuczynski in https://github.com/faker-js/faker/pull/703Full Changelog: https://github.com/faker-js/faker/compare/v6.0.0...v6.1.0
⚠WARNING: This build is broken due to missing build files. Please don't use this version!
docs: show union options parameters by @ST-DDT in https://github.com/faker-js/faker/pull/602
Full Changelog: https://github.com/faker-js/faker/compare/v5.5.3...v6.0.0 Since last beta Changelog: https://github.com/faker-js/faker/compare/v6.0.0-beta.0...v6.0.0
docs: show deprecation warnings in api docs by @ST-DDT in https://github.com/faker-js/faker/pull/524
Full Changelog: https://github.com/faker-js/faker/compare/v6.0.0-alpha.7...v6.0.0-beta.0
test: rewrite git tests by @Shinigami92 in https://github.com/faker-js/faker/pull/425
Full Changelog: https://github.com/faker-js/faker/compare/v6.0.0-alpha.6...v6.0.0-alpha.7
chore: ignore some more files by @Shinigami92 in https://github.com/faker-js/faker/pull/292
Full Changelog: https://github.com/faker-js/faker/compare/v6.0.0-alpha.5...v6.0.0-alpha.6
fix: revert pnpm only-allow by @damienwebdev in https://github.com/faker-js/faker/pull/291
Full Changelog: https://github.com/faker-js/faker/compare/v6.0.0-alpha.4...v6.0.0-alpha.5
add autocomplete support for locales
Full Changelog: https://github.com/faker-js/faker/compare/v6.0.0-alpha.3...v6.0.0-alpha.4
Demo: https://stackblitz.com/edit/typescript-wsqtmx?file=index.ts
Demo: https://stackblitz.com/edit/typescript-wsqtmx?file=index.ts
id, ponpes.id and net.id domains for id_ID (#137) (ce4d48e)Full Changelog: https://github.com/faker-js/faker/compare/v6.0.0-alpha.2...v6.0.0-alpha.3
chore: bring readme changes from shepherd repo by @clarkerican in https://github.com/faker-js/faker/pull/25
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →