FakerLocalization
Switching locales
Did you know Faker supports many different locales?
By default, when using import { faker } from '@faker-js/faker' actually every available locale that is supported by Faker will be loaded and you can switch the locale at runtime with faker.setLocale('de').
TIP
Alternatively you can also just use faker.locale = 'de' instead to switch the locale.
Individual localized packages
By default, Faker will include all locale data.
This might result in loading around 5 MB of data into memory and slow down startup times.
But we got your back!
When encountering such a problem in a test or production environment, you can use the individual localized packages.
ts
import { faker } from '@faker-js/faker/locale/de';
This will then just load the German locales with additional English locales as fallback. The fallback is required due to not all locales containing data for all features. If you encounter a missing locale entry in your selected language, feel free to open a Pull Request fixing that issue.
INFO
The English locales are around 600 KB in size.
All locales together are around 5 MB in size.
Available locales
| Locale | Name |
|---|---|
| af_ZA | Afrikaans |
| ar | Arabic |
| az | Azerbaijani |
| cz | Czech |
| de | German |
| de_AT | German (Austria) |
| de_CH | German (Switzerland) |
| el | Greek |
| en | English |
| en_AU | English (Australia) |
| en_AU_ocker | English (Australia Ocker) |
| en_BORK | English (Bork) |
| en_CA | English (Canada) |
| en_GB | English (Great Britain) |
| en_GH | English (Ghana) |
| en_IE | English (Ireland) |
| en_IND | English (India) |
| en_NG | Nigeria (English) |
| en_US | English (United States) |
| en_ZA | English (South Africa) |
| es | Spanish |
| es_MX | Spanish (Mexico) |
| fa | Farsi |
| fi | Finnish |
| fr | French |
| fr_BE | Français (Belgique) |
| fr_CA | French (Canada) |
| fr_CH | French (Switzerland) |
| ge | Georgian |
| he | Hebrew |
| hr | Hrvatski |
| hu | Hungarian |
| hy | Armenian |
| id_ID | Indonesian |
| it | Italian |
| ja | Japanese |
| ko | Korean |
| lv | Latvian |
| mk | Macedonian |
| nb_NO | Norwegian |
| ne | Nepalese |
| nl | Dutch |
| nl_BE | Dutch (Belgium) |
| pl | Polish |
| pt_BR | Portuguese (Brazil) |
| pt_PT | Portuguese (Portugal) |
| ro | Romanian |
| ru | Russian |
| sk | Slovakian |
| sv | Swedish |
| tr | Turkish |
| uk | Ukrainian |
| ur | Urdu |
| vi | Vietnamese |
| zh_CN | Chinese |
| zh_TW | Chinese (Taiwan) |
| zu_ZA | Zulu (South Africa) |