Working with File System

When js-dos player successfully starts, the DOSBox command interface is available. You can get it from the event:

 Dos(/*element*/, {
    url: /* bundle url */,
    onEvent: ("ci-ready", ci: CommandInterface) {
        // now ci s ready
    },
);

With ci you can interact with a DOS file system.

Read file from FS

fsReadFile(file: string): Promise<Uint8Array>;

This function will read the file from the given path and return the promise to Uint8Array.

fsWriteFile(file: string, contents: ReadableStream<Uint8Array> | Uint8Array): Promise<void>;

This method will write contents into the provided file.

fsDeleteFile(file: string): Promise<void>;

Delete file from FS.

You can read the full file system structure by calling:

fsTree(): Promise<FsNode>;

The FsNode contains following:

export interface FsNode {
    name: string;
    size: number | null;
    nodes: FsNode[] | null;
}

Emscripten API is even more powerful, but also low level. You can access it only in direct mode.

Last modified: 03 октября 2024