i18n.Function.getOutfittingFamilyName

@elite-dangerous-almanac/core / i18n / getOutfittingFamilyName

Function: getOutfittingFamilyName()

getOutfittingFamilyName(familyId, locale): string | null

Defined in: src/i18n/module-families.ts:40

Look up an outfitting family's source-backed display name for a locale.

Parameters

familyId

string

The stable family id carried by OutfittingModuleIdentity.familyId, such as "shieldGenerators". Matching ignores case and surrounding whitespace.

locale

string

A BCP 47 language or regional tag, such as "de", "de-DE" or "en-GB". Matching is case-insensitive; underscores are accepted in place of hyphens. A regional or script subtag is dropped: every stored locale is a bare language tag.

Returns

string | null

The localized family name; the canonical OUTFITTING_FAMILIES name for any English tag; or null when the family is unknown, the locale is unsupported, or the pinned source carries no category label for that family and locale.

Remarks

Every module carries a family, so an outfitting list can group and label every choice ShipLoadout.modulesForSlot() returns from this lookup alone. The table bundles no module stats. Missing translations never silently fall back to English: 19 of the 77 families have no source-backed label in any locale, tracked by #320.

Throws

If familyId is present and not a string, or locale is not a string. A nullish familyId is a lookup miss and returns null.

Example

import { getOutfittingFamilyName } from '@elite-dangerous-almanac/core/i18n/module-families';

getOutfittingFamilyName('shieldGenerators', 'de-DE'); // -> 'Schildgeneratoren'
getOutfittingFamilyName('xenoScanners', 'de'); // -> null