ships.Function.getBlueprintGrade

@elite-dangerous-almanac/core / ships / getBlueprintGrade

Function: getBlueprintGrade()

getBlueprintGrade(blueprintSymbol, grade): BlueprintGrade | null

Defined in: src/ships/blueprints.ts:110

Look up one complete grade of a blueprint, case-insensitively.

Parameters

blueprintSymbol

string

The blueprint id, e.g. "FSD_LongRange". Leading/trailing whitespace and case are ignored.

grade

number

The grade, 1–5.

Returns

BlueprintGrade | null

The grade record — its modifier features and optional converted damageDistribution — or null if the catalogue holds no such blueprint or grade. See getBlueprint for what an absent blueprint can mean besides "unknown".

Throws

If grade is not an integer from 1 through 5.

Throws

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

Example

import { getBlueprintGrade } from '@elite-dangerous-almanac/core/ships/blueprints';

const grade = getBlueprintGrade('FSD_LongRange', 5);
grade?.features;  // -> [{ label: 'Integrity', ... }, ...]