Class: shaka.util.LanguageUtils

Members

(private, static, constant, non-null) isoMap_ :Object.<string, string>

A map from 3-letter language codes (ISO 639-2) to 2-letter language codes (ISO 639-1) for all languages which have both in the registry.

Type:

• Object.<string, string>

Source:

• lib/util/language_utils.js, line 118

(static) MatchType :number

A match type for fuzzy-matching logic.

Type:

• number

Properties:

Name	Type	Description
EXACT	number	Accepts an exact match.
BASE_LANGUAGE_OKAY	number	Accepts a less-specific version of the preferred sublanguage.
OTHER_SUB_LANGUAGE_OKAY	number	Accepts a different sublanguage of the preferred base language.

Source:

• lib/util/language_utils.js, line 76

Methods

(static) match(fuzz, preference, candidate) → {boolean}

Compares two language tags as defined by RFC 5646 and ISO 639. The comparison takes sublanguages into account via the |fuzz| parameter. The caller is expected to normalize the inputs first.

Parameters:

Name	Type	Description
fuzz	shaka.util.LanguageUtils.MatchType	What kind of match is acceptable.
preference	string	The user's preferred language tag.
candidate	string	An available language tag.

Source:

• lib/util/language_utils.js, line 44

See:

• shaka.util.LanguageUtils.normalize()
• IETF RFC 5646
• ISO 639

Returns:

Type

boolean

(static) normalize(lang) → {string}

Normalize the language tag. RFC 5646 specifies that language tags are case insensitive and that the shortest representation of the base language should always be used. This will convert the tag to lower-case and map 3-letter codes (ISO 639-2) to 2-letter codes (ISO 639-1) whenever possible.

Parameters:

Name	Type	Description
lang	string

Source:

• lib/util/language_utils.js, line 100

See:

• IETF RFC 5646
• ISO 639

Returns:

Type

string