getCountryFlagByCode

v0.0.5

Convert an ISO 3166-1 alpha-2 country code (e.g. 'RU', 'us') into its flag emoji by mapping each letter to a Unicode regional indicator symbol. Case-insensitive; returns an empty string for anything that isn't two ASCII letters. Pure and environment-agnostic.

Source

Example

getCountryFlagByCode('RU'); // '🇷🇺'
getCountryFlagByCode('us'); // '🇺🇸'
getCountryFlagByCode('123'); // ''

Signature

export function getCountryFlagByCode(code: string): string{ ... }

Parameters

Parameter	Type	Default	Description
`code`	`string`	—	The ISO 3166-1 alpha-2 code, e.g. `'US'`

Returns

stringThe flag emoji (e.g. '🇺🇸'), or '' when the code is invalid

Related Types

PhoneCountry

Phone-number formats for every country: an international template with the dialing-code digits as # digit placeholders, plus the priority/areaCodes used to disambiguate countries sharing a dialing code (NANP +1, +7 RU/KZ). NANP territories are normalized to code '1' (their 3-digit prefix moved into areaCodes), so every dialing code is prefix-free and the +1 block shares one numbering-plan template. Derived from the MIT-licensed react-phone-input-2 dataset — display formats, not authoritative validation.

interface PhoneCountry

Property	Type	Default	Description
`name`?readonly	`string`	—	Display name, e.g. `'United States'` (omit for custom lists).
`iso2`?readonly	`string`	—	ISO 3166-1 alpha-2 code, lowercase, e.g. `'us'` (omit for custom lists).
`code`readonly	`string`	—	International dialing code digits (no `+`), e.g. `'1'`, `'380'`.
`template`readonly	`string`	—	International template; `#` is a digit, e.g. `'+# (###) ###-####'`.
`priority`?readonly	`number`	—	Order among countries sharing `code` — lower wins when no area code matches. Absent means `0` (the primary country for that code).
`areaCodes`?readonly	`readonly string[]`	—	Area codes (the digits right after `code`) that belong to this country.