Skip to content

materials.Function.getMaterialByName

github-actions[bot] edited this page Aug 26, 2026 · 74 revisions

@elite-dangerous-almanac/core / materials / getMaterialByName

Function: getMaterialByName()

getMaterialByName(name, materials?): Material | null

Defined in: src/materials/materials.ts:243

Look up a material by its display name (case-insensitive).

Parameters

name

string

The display name as the catalogue spells it, e.g. "Grid Resistors". Leading/trailing whitespace and case are ignored.

materials?

readonly Material[] = ALL_MATERIALS

Optional subset to search (see getMaterialBySymbol).

Returns

Material | null

The matching Material, or null if no material has that name.

Throws

If name is present and not a string. A nullish name is a miss, answered the way an unrecognised one is.

Example

import { getMaterialByName } from '@elite-dangerous-almanac/core/materials/materials';

getMaterialByName('imperial shielding')?.grade; // -> 5

API

Guides
astro
Classes (1)
ProceduralSystem

Properties

Accessors

Methods

Interfaces (16)
Type Aliases (3)
Variables (11)
Functions (37)
Subpath modules (3)
commodities
Interfaces (1)
Type Aliases (1)
Variables (3)
Functions (3)
equipment
Interfaces (6)
Type Aliases (8)
Variables (3)
Functions (10)
Subpath modules (2)
i18n
Interfaces (1)
Type Aliases (1)
Functions (17)
materials
Enumerations (2)
Interfaces (2)
Type Aliases (2)
Variables (9)
Functions (9)
ships
Classes (3)
BuildMetrics

Methods

LoadoutEditError

Constructors

Properties

Methods

ShipLoadout

Accessors

Methods

Interfaces (125)
Type Aliases (44)
Variables (10)
Functions (85)
Subpath modules (8)

Clone this wiki locally