Skip to content

Latest commit

 

History

History
97 lines (83 loc) · 3.84 KB

localization.md

File metadata and controls

97 lines (83 loc) · 3.84 KB

Localization

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.

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)