Class 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);
}

Hierarchy

  • Application

Properties

author icon? id nacp name version

Accessors

self

Methods

createSaveData launch mountSaveData [iterator] fromNRO

Properties

Readonly author

author: string

The author or publisher of the application.

Optional Readonly icon

icon?: ArrayBuffer

The raw JPEG data for the cover art of the application. Can be decoded with the Image class.

Readonly id

id: bigint

The 64-bit unique identifier of the application.

Readonly nacp

nacp: ArrayBuffer

The raw NACP data of the application. Use the @tootallnate/nacp module to parse this data.

Readonly name

name: string

The name of the application.

Readonly version

version: string

The version of the application.

Accessors

Static self

  • get self(): Application

  • An Application instance representing the currently running application.

    Returns Application

Methods

createSaveData

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

    Parameters

    Returns void

    Example

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

launch

  • Launches the application.

    Returns never

    Note

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

mountSaveData

  • Mounts the save data for this application such that filesystem operations may be used.

    Parameters

    • name: string

      The name of the device mount for filesystem paths.

    • profile: Profile

      The Profile which the save data belongs to.

    Returns FsDev

    Example

    const profile = Switch.currentProfile({ required: true });
    const device = app.mountSaveData('save', profile);

    // Use the filesystem functions to do operations on the save mount
    console.log(Switch.readDirSync('save:/'));

    // Make sure to use `device.commit()` after any write operations
    Switch.writeFileSync('save:/state', 'your app state…');
    device.commit();

Static [iterator]

Static fromNRO

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

    Parameters

    Returns Application

    Example

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

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc