ships.Function.getExperimentalsForModule

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

Function: getExperimentalsForModule()

getExperimentalsForModule(symbol): readonly string[]

Defined in: ships/engineering-options.ts:297

Every experimental effect a module can take — its group's list, minus the effects that particular module is excluded from.

Most modules take their whole group's list, but 24 are exceptions: 13 Multi-cannons cannot take Phasing Sequence, six dumbfire racks cannot take Drag Munitions, four missile racks are short of Penetrator Munitions or FSD Interrupt, and the small fixed Abrasion Blaster takes blueprints but no experimental at all. Those are applied here, so the result is the exact set for this module.

An empty array is the common answer, and it usually means "blueprints only". 388 of the 1028 grouped modules have no experimental slot: 387 sit in the 30 of 53 groups that offer none — life support, sensors, the limpet controllers, the utility scanners, and every Guardian group, weapons and modules alike — and the Abrasion Blaster is excluded from its group's only effect. An ungrouped module answers empty too; getEngineeringGroup tells the two apart: it is null only for that one.

Parameters

symbol

string

A module symbol.

Returns

readonly string[]

Experimental-effect ids. Join to EXPERIMENTAL_EFFECTS.

Throws

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

Example

import { getExperimentalsForModule } from '@elite-dangerous-almanac/core/ships/engineering-options';

getExperimentalsForModule('Hpt_MultiCannon_Fixed_Medium').length; // -> 12

// The small Multi-cannon is one effect short — no Phasing Sequence.
getExperimentalsForModule('Hpt_MultiCannon_Fixed_Small').length; // -> 11

// Grouped, so it has blueprints — but it takes no experimental.
getExperimentalsForModule('Hpt_Mining_AbrBlstr_Fixed_Small'); // -> []