Application

Represents an installed application (game) on the console, or a homebrew application (.nro file).

Can be used as an iterator to retrieve the list of installed applications.

Example

for (const app of Switch.Application) {
  console.log(app.name);
}

Constructors

new Application()

new Application(id): Application

Creates an Application instance from the ID of an installed application.

Parameters

Parameter	Type	Description
`id`	`bigint`	The ID of the installed application.

Returns

Application

Example

const app = new Switch.Application(0x100bc0018138000n);
console.log(app.name);

new Application()

new Application(nro): Application

Creates an Application instance from an ArrayBuffer containing the contents of a .nro homebrew application.

Parameters

Parameter	Type	Description
`nro`	`ArrayBuffer`	The contents of the `.nro` file.

Returns

Application

Example

const nro = await Switch.readFile('sdmc:/hbmenu.nro');
const app = new Switch.Application(nro);
console.log(app.name);

Properties

Property	Modifier	Type	Description
`author`	`readonly`	`string`	The author or publisher of the application.
`icon?`	`readonly`	`ArrayBuffer`	The raw JPEG data for the cover art of the application. Can be decoded with the `Image` class.
`id`	`readonly`	`bigint`	The 64-bit unique identifier of the application (`PresenceGroupId`).
`nacp`	`readonly`	`ArrayBuffer`	The raw NACP data of the application. Use the `@tootallnate/nacp` module to parse this data.
`name`	`readonly`	`string`	The name of the application.
`version`	`readonly`	`string`	The version of the application.

Accessors

self

get static self(): Application

An Application instance representing the currently running application.

Returns

Application

Methods

createCacheSaveDataSync()

createCacheSaveDataSync(index, info?): SaveData

Creates the Cache storage for this Application for the specified save index ID.

Parameters

Parameter	Type	Default value	Description
`index`	`number`	`0`	The save index ID. Defaults to `0`.
`info`?	`Partial`<`SaveDataCreationInfoWithNacp`>	`undefined`	-

Returns

SaveData

createProfileSaveDataSync()

createProfileSaveDataSync(profile, info?): SaveData

Creates the Save Data for this Application for the provided user profile.

Parameters

Parameter	Type	Description
`profile`	`Profile`	The Profile to create the save data for.
`info`?	`Partial`<`SaveDataCreationInfoWithNacp`>	-

Returns

SaveData

Example

const profile = Switch.currentProfile({ required: true });
app.createSaveData(profile);

createSaveDataSync()

createSaveDataSync(info): SaveData

Parameters

Parameter	Type
`info`	`SaveDataCreationInfoWithNacp`

Returns

SaveData

filterSaveData()

filterSaveData(filter?): Generator<SaveData, void, unknown>

Parameters

Parameter	Type
`filter`?	`Omit`<`SaveDataFilter`, `"applicationId"`>

Returns

Generator<SaveData, void, unknown>

findSaveData()

findSaveData(filter): undefined | SaveData

Parameters

Parameter	Type
`filter`	`Omit`<`SaveDataFilter`, `"applicationId"`>

Returns

undefined | SaveData

launch()

launch(): never

Launches the application.

Returns

never

Note

This only works for installed applications (not homebrew apps).

[iterator]()

static [iterator](): Generator<Application, void, unknown>

Returns

Generator<Application, void, unknown>

Application

On this page