# What changed in @faker-js/faker

> 96 changes in @faker-js/faker 10 from its official release notes, upgrade guides and advisories: 2 breaking, 1 security, 43 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/@faker-js/faker/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @faker-js/faker 10

### Breaking changes

- Stops scaling the HSLA alpha into a percentage. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Rejects refDates that a ULID timestamp cannot encode. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)

### Security

- Faker: helpers.fake exploitable into arbritary code execution (10.5.0) — [security advisory](https://github.com/advisories/GHSA-QXC2-J82W-R537)

### New APIs and options

- Adds vehicle data for the de locale. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Adds 060 Japanese mobile phone number formats. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Adds Norwegian animal data for the nb_NO locale. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Adds Norwegian food data for the nb_NO locale. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Changes ne to Devangari and adds en_NP. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Introduces the NumberRange type. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Adds Welsh locale data for sex, direction, animals, vehicle fuel, book format, counties, postal addresses and postcodes, internet domain suffixes, phone numbers, continents, city names, street names, states, and building numbers. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds color data for the cy locale. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Can now accept a year range when generating a future date. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Can now accept a year range when generating a past date. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Can now accept a date range when generating a recent date. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Can now accept a date range when generating a soon date. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds postal_address data and improves secondary_address data. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds Farsi airline locale data. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Exposes core.locale as a LocaleProxy. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Introduces FakerCore as a core Faker API. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds the sl_SI locale with location module data. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds the mn_MN_cyrl Mongolian locale. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds postal address generation. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds distributor functions to the number module. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds a mobile style for generated phone numbers. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds the first standalone module functions. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds a Norwegian country definition for the nb_NO locale. (10.4.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.4.0)
- UUID v7 is now supported. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- Japanese color definitions are added. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- A Japanese dog definition is added. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- A Japanese food module is added. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- Japanese internet definitions are added. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- Japanese job definitions are added for the person module. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- Japanese suffix definitions are added for the person module. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- Norwegian continent definitions are added. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- A Norwegian direction definition is added. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- Norwegian sex definitions are added. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- A Norwegian vehicle definition is added. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- Norwegian zodiac sign definitions are added. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- Adds a location module for the bn_BD locale. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Adds states (regions) to the Danish locale. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Adds Hungarian city names, full street addresses, continents, countries, and directions. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Adds Indonesian translations for animal, color, commerce, and word data, and adds country data to location. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Adds person module data to the ku_ckb locale. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Adds the ku_kmr_latin locale. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Adds the sl_SI locale and its person module data. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Adds support for UPC. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)

### Behavior and default changes

- Organizes first names by gender in the en locale. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Improves middle names organized by gender for the en locale. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Adds mobile phone number styles for more locales. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Adds more realistic Greek address data. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Improves en_GB postcode data. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Improves en_IE postal address data. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Expands plant-based dish and pattern variety. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Extends Turkish person last names. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds Japanese cat breed definitions. (10.4.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.4.0)
- Adds Japanese horse breed definitions. (10.4.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.4.0)
- Adds plant-based dish variety. (10.4.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.4.0)
- sexType can now return 'generic'. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- Allows product name patterns to vary by locale. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Uses accents in English country names. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Adds support for Iranian IBANs. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Removes some negative words from the Hungarian locale. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Removes offensive and inappropriate words from the Japanese locale. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Adds counties and states to nb_NO location data. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)
- Moves raspberry from the vegetable category to the fruit category. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)

### Fixes and other changes

- Gives the LCH hue its full 360 degree range. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Fixes handling of prototype property keys. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Validates CIDR prefix length and octet range in ipv4(). (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Generates long passwords without causing a stack overflow. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Excludes reserved port 0 from generated internet ports. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Excludes forbidden letter combinations from Dutch postcodes. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Generates only valid French postal codes. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Uses only valid letters in en_CA postcodes. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Calculates the VIN check digit. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- The closest strategy now picks the nearest word length. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Updates the nl_BE phone number patterns. (10.6.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.6.0)
- Fixes an incorrect date boundary in past and future. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Fixes an incorrect date boundary in past and future. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Fixes a typo in de_CH last names. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Corrects fruit and vegetable locale data. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Fixes phone numbers for en_AU. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Corrects Farsi phone locales. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Fixes lazy results in fake. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Validates unsupported fileExt mime types. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- routingNumber now uses a real FederalReserveRoutingSymbol from a lookup table. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Ignores wrapper characters in fromRegExp and handles single-character patterns. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Removes citation brackets from snake names. (10.5.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.5.0)
- Adds Japanese bear definitions. (10.4.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.4.0)
- Adds Japanese bird definitions. (10.4.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.4.0)
- Adds Japanese cattle breed definitions. (10.4.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.4.0)
- Adds Japanese fish definitions. (10.4.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.4.0)
- Corrects typos and capitalization in Mexican Spanish street names. (10.4.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.4.0)
- Adds phone numbers for the fi locale. (10.4.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.4.0)
- Empty strings are removed from Hebrew lorem words. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- The state name is corrected to Trøndelag for the nb_NO locale. (10.3.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.3.0)
- Corrects the locale endonym to use Latin script. (10.2.0) — [release notes](https://github.com/faker-js/faker/releases/tag/v10.2.0)