Meta tags:
description=Generate massive amounts of fake (but reasonable) data for testing and development.;

Headings (most frequently used words):

locales, handling, data, errors, localization, guide, api, contributing, about, switching, custom, and, fallbacks, available, locale, codes, missing, not, applicable, modules, announcements, roadmap,

Text of the page (most frequently used words):
faker (60), the (36), #locale (36), for (27), english (20), data (19), you (17), this (16), locales (14), import (14), from (12), that (11), can (11), are (10), and (9), location (9), console (9), error (8), base (8), custom (7), your (7), example (7), log (6), en_hk (6), not (6), have (6), french (6), german (6), fallbacks (5), const (5), use (5), all (5), missing (5), instance (5), allfakers (5), definitions (5), de_at (5), instances (5), which (5), definition (5), page (4), postcode (4), new (4), will (4), code (4), want (4), please (4), note (4), these (4), there (4), some (4), provide (4), using (4), localization (4), key (4), different (4), australia (4), latin (4), de_ch (4), 2022 (3), frameworks (3), also (3), zipcode (3), following (3), null (3), other (3), fallback (3), them (3), contributing (3), about (3), values (3), used (3), handling (3), fakeren_hk (3), codes (3), belgium (3), more (3), guide (3), language (3), with (3), fakerde (3), south (3), africa (3), switzerland (3), our (3), customlocale (3), present (2), next (2), usage (2), see (2), does (2), languages (2), countries (2), think (2), consider (2), relevant (2), cases (2), set (2), but (2), could (2), receive (2), means (2), unable (2), method (2), same (2), report (2), https (2), category (2), entry (2), applicable (2), txt (2), errors (2), well (2), country (2), additional (2), has (2), person (2), name (2), try (2), keys (2), object (2), alllocales (2), dir (2), prebuilt (2), way (2), access (2), imports (2), needed (2), variant (2), may (2), after (2), underscore (2), ocker (2), serbian (2), serbia (2), sr_rs_latin (2), en_au_ocker (2), phone (2), two (2), represents (2), united (2), states (2), en_au (2), en_us (2), iso (2), standard (2), first (2), arabic (2), however (2), most (2), specific (2), every (2), chinese (2), nigeria (2), india (2), romanian (2), portuguese (2), dutch (2), kurdish (2), canada (2), spanish (2), available (2), contains (2), generic (2), needs (2), internet (2), localedefinition (2), built (2), build (2), own (2), team (2), roadmap (2), announcements (2), randomizer (2), api (2), v10 (2), navigation (2), open (2), collective (2), copyright, released, under, mit, license, previous, pager, suggest, changes, since, considered, any, work, warning, 17551, 0348, instead, define, like, far, experts, provided, create, issue, explicitly, clarify, thought, valid, put, empty, array, stored, objects, works, both, without, downstream, current, reasonable, zip, hongkong, reason, applies, methods, bug, github, com, aren, course, workaround, yet, others, future, information, fakerjs, dev, html, contribute, project, occurred, catch, fullname, sample, let, useful, enumerate, raw, recommended, one, individual, shown, above, via, where, rarely, fully, represent, accented, written, scripts, appended, another, dialect, script, spoken, patterns, addresses, numbers, etc, optionally, letter, uppercase, added, 3166, alpha, named, systematic, characters, lowercase, 639, limited, coverage, rely, heavily, source, features, they, currently, beneficial, long, term, specifying, reduces, time, necessary, startup, compounding, effect, testing, reload, execution, columns, refer, respective, names, fakerzu_za, zulu, zu_za, fakerzh_tw, taiwan, zh_tw, fakerzh_cn, china, zh_cn, fakeryo_ng, yoruba, yo_ng, fakervi, vietnamese, fakeruz_uz_latin, uzbek, uzbekistan, uz_uz_latin, fakerur, urdu, fakeruk, ukrainian, fakertr, turkish, fakerth, thai, fakerta_in, tamil, ta_in, fakersv, swedish, fakersr_rs_latin, fakersl_si, slovenian, slovenia, sl_si, fakersk, slovak, fakerru, russian, fakerro_md, moldova, ro_md, fakerro, fakerpt_pt, portugal, pt_pt, fakerpt_br, brazil, pt_br, fakerpl, polish, fakernl_be, nl_be, fakernl, fakerne, nepali, fakernb_no, norwegian, norway, nb_no, fakermn_mn_cyrl, mongolian, mongolia, cyrillic, mn_mn_cyrl, fakermk, macedonian, fakerlv, latvian, fakerku_kmr_latin, kurmanji, ku_kmr_latin, fakerku_ckb, sorani, ku_ckb, fakerko, korean, fakerka_ge, georgian, georgia, ka_ge, fakerja, japanese, fakerit, italian, fakerid_id, indonesian, indonesia, id_id, fakerhy, armenian, fakerhu, hungarian, fakerhr, croatian, fakerhe, hebrew, fakerfr_sn, senegal, fr_sn, fakerfr_lu, luxembourg, fr_lu, fakerfr_ch, fr_ch, fakerfr_ca, fr_ca, fakerfr_be, fr_be, fakerfr, fakerfi, finnish, fakerfa, farsi, persian, fakeres_mx, mexico, es_mx, fakeres, fakereo, esperanto, fakeren_za, en_za, fakeren_us, fakeren_ng, en_ng, fakeren_in, en_in, fakeren_ie, ireland, en_ie, hong, kong, fakeren_gh, ghana, en_gh, fakeren_gb, great, britain, en_gb, fakeren_ca, en_ca, fakeren_bork, bork, en_bork, fakeren_au_ocker, fakeren_au, fakeren, fakerel, greek, fakerdv, maldivian, fakerde_ch, fakerde_at, austria, fakerda, danish, fakercy, welsh, fakercs_cz, czech, czechia, cs_cz, fakerbn_bd, bengali, bangladesh, bn_bd, fakerbase, fakeraz, azerbaijani, fakerar, fakeraf_za, afrikaans, af_za, emojis, complete, add, fill, gaps, depending, might, overrides, override, each, checked, order, requested, customfaker, export, test, domainsuffix, title, type, don, satisfy, overwrites, did, know, supports, many, when, default, get, pre, than, switching, continue, cleanup, improvements, make, handier, tree, shakeable, module, functions, 2024, submit, pull, request, development, environment, propose, feature, bugs, conduct, word, vehicle, system, string, science, number, music, lorem, image, helpers, hacker, git, food, finance, date, datatype, database, company, commerce, color, book, animal, airline, modules, utilities, distributors, simplefaker, overview, upgrading, unique, getting, started, sidebar, return, top, menu, appearance, release, notes, browser, stackblitz, main, ctrl, search, skip, content,

Text of the page (random words):
localization faker skip to content faker search ctrl k main navigation guide api try it stackblitz browser console about announcements roadmap team v10 5 0 release notes next v9 9 0 v8 4 1 v7 6 0 v6 3 1 open collective appearance open collective menu return to top sidebar navigation guide getting started usage localization frameworks randomizer unique values upgrading to v10 api overview faker simplefaker randomizer distributors utilities modules airline animal book color commerce company database datatype date finance food git hacker helpers image internet location lorem music number person phone science string system vehicle word contributing code of conduct report bugs propose a feature set up a development environment submit a pull request about announcements 2024 10 26 2022 09 08 2022 01 14 roadmap v9 tree shakeable module functions v8 make faker handier v7 cleanup improvements v6 continue faker team on this page localization switching locales did you know faker supports many different locales when using our default instance import faker from faker js faker you get english data however we also provide pre built instances for more than 70 available locales for example you can import the german locale import fakerde as faker from faker js faker note you can also build your own faker instances with custom locales overwrites custom locales and fallbacks if our built in faker instances don t satisfy your needs you can build your own ts import type localedefinition from faker js faker import base de de_ch en faker from faker js faker const customlocale localedefinition title my custom locale internet domainsuffix test export const customfaker new faker locale customlocale de_ch de en base in this example there are 5 locales each of these is checked in order and the first locale which contains the requested data will be used customlocale is your custom locale definition which will override all other fallback definitions de_ch is a specific locale definition that overrides some german definitions with ch switzerland data de is a generic de german locale definition en is a generic en english locale definition this is our most complete locale so we add it to fill some gaps depending on your needs you might want or not want to have it as a fallback base is the base locale definition which contains definitions that can be used in every language e g emojis available locales locale name faker af_za afrikaans south africa fakeraf_za ar arabic fakerar az azerbaijani fakeraz base base fakerbase bn_bd bengali bangladesh fakerbn_bd cs_cz czech czechia fakercs_cz cy welsh fakercy da danish fakerda de german fakerde de_at german austria fakerde_at de_ch german switzerland fakerde_ch dv maldivian fakerdv el greek fakerel en english fakeren en_au english australia fakeren_au en_au_ocker english australia ocker fakeren_au_ocker en_bork english bork fakeren_bork en_ca english canada fakeren_ca en_gb english great britain fakeren_gb en_gh english ghana fakeren_gh en_hk english hong kong fakeren_hk en_ie english ireland fakeren_ie en_in english india fakeren_in en_ng english nigeria fakeren_ng en_us english united states fakeren_us en_za english south africa fakeren_za eo esperanto fakereo es spanish fakeres es_mx spanish mexico fakeres_mx fa farsi persian fakerfa fi finnish fakerfi fr french fakerfr fr_be french belgium fakerfr_be fr_ca french canada fakerfr_ca fr_ch french switzerland fakerfr_ch fr_lu french luxembourg fakerfr_lu fr_sn french senegal fakerfr_sn he hebrew fakerhe hr croatian fakerhr hu hungarian fakerhu hy armenian fakerhy id_id indonesian indonesia fakerid_id it italian fakerit ja japanese fakerja ka_ge georgian georgia fakerka_ge ko korean fakerko ku_ckb kurdish sorani fakerku_ckb ku_kmr_latin kurdish kurmanji latin fakerku_kmr_latin lv latvian fakerlv mk macedonian fakermk mn_mn_cyrl mongolian mongolia cyrillic fakermn_mn_cyrl nb_no norwegian norway fakernb_no ne nepali fakerne nl dutch fakernl nl_be dutch belgium fakernl_be pl polish fakerpl pt_br portuguese brazil fakerpt_br pt_pt portuguese portugal fakerpt_pt ro romanian fakerro ro_md romanian moldova fakerro_md ru russian fakerru sk slovak fakersk sl_si slovenian slovenia fakersl_si sr_rs_latin serbian serbia latin fakersr_rs_latin sv swedish fakersv ta_in tamil india fakerta_in th thai fakerth tr turkish fakertr uk ukrainian fakeruk ur urdu fakerur uz_uz_latin uzbek uzbekistan latin fakeruz_uz_latin vi vietnamese fakervi yo_ng yoruba nigeria fakeryo_ng zh_cn chinese china fakerzh_cn zh_tw chinese taiwan fakerzh_tw zu_za zulu south africa fakerzu_za the locale data and faker columns refer to the respective import names ts import de fakerde from faker js faker note some locales have limited coverage and rely more heavily on the english locale as the source for features they currently do not have however in most cases using a specific locale will be beneficial in the long term as specifying a locale reduces the time necessary for startup which has a compounding effect on testing frameworks that reload the imports every execution locale codes locales are named in a systematic way the first two characters are a lowercase language code following the iso 639 1 standard for example ar for arabic or en for english the same language may be spoken in different countries with different patterns for addresses phone numbers etc optionally a two letter uppercase country code can be added after an underscore following the iso 3166 1 alpha 2 standard for example en_us represents english united states and en_au represents english australia rarely an additional variant may be needed to fully represent an accented variant of the locale or for languages which can be written in different scripts this is appended after another underscore for example en_au_ocker english in australia in ocker dialect or sr_rs_latin serbian in serbia in latin script the recommended way to access faker instances is by using one of the individual imports as shown above if needed you can access all prebuilt faker instances or all locale definitions via an object where the locale codes are the keys ts import allfakers alllocales from faker js faker console dir allfakers de_at the prebuilt faker instance for de_at console dir alllocales de_at the raw locale definitions for de_at this could be useful if you want to enumerate all locales for example ts import allfakers from faker js faker for let key of object keys allfakers try console log in locale key a sample name is allfakers key person fullname catch e console log in locale key an error occurred e handling missing data errors txt error the locale data for category entry are missing in this locale please contribute the missing data to the project or use a locale faker instance that has these data for more information see https fakerjs dev guide localization html if you receive this error this means you are using a locale faker instance that does not have the relevant data for that method yet please consider contributing the missing data so that others can use them in the future as well as a workaround you can provide additional fallbacks to your faker instance ts import faker el from faker js faker import faker base el en from faker js faker const faker new faker locale el locale el en base console log faker location country belgium note of course you can use custom locales and fallbacks for this as well handling not applicable data errors txt error the locale data for category entry aren t applicable to this locale if you think this is a bug please report it at https github com faker js faker if you receive this error this means the current locale is unable to provide reasonable values for that method for example there are no zip codes in hongkong so for that reason the en_hk locale is unable to provide these data the same applies to other locales and methods ts import fakeren_hk from faker js faker console log fakeren_hk location zipcode error for these cases we explicitly set the data to null to clarify that we have thought about it but there are no valid values to put there we could have used an empty array but some locale data are stored as objects so null works for both of them without custom downstream handling of missing data note we are by far no experts in all provided languages countries locales so if you think this is an error for your locale please create an issue and consider contributing the relevant data if you want to use other fallback data instead you can define them like this ts import faker en en_hk from faker js faker const faker new faker locale location postcode en location postcode en_hk console log faker location zipcode 17551 0348 warning since null is considered present data it will not use any fallbacks for that so the following code does not work ts import faker en en_hk from faker js faker const faker new faker locale en_hk location postcode en location postcode console log faker location zipcode error see also custom locales and fallbacks suggest changes to this page pager previous page usage next page frameworks released under the mit license copyright 2022 present faker