Interface FileWillCreateEvent

An event that is fired when files are going to be created.

To make modifications to the workspace before the files are created, call the [`waitUntil](#FileWillCreateEvent.waitUntil)-function with a thenable that resolves to a workspace edit.

interface FileWillCreateEvent {
    files: readonly Uri[];
    token: CancellationToken;
    waitUntil(thenable): void;
    waitUntil(thenable): void;
}

Properties

Methods

Properties

files: readonly Uri[]

The files that are going to be created.

A cancellation token.

Methods

  • Allows to pause the event and to apply a workspace edit.

    Note: This function can only be called during event dispatch and not in an asynchronous manner:

    workspace.onWillCreateFiles(event => {
    // async, will *throw* an error
    setTimeout(() => event.waitUntil(promise));

    // sync, OK
    event.waitUntil(promise);
    })

    Parameters

    Returns void

  • Allows to pause the event until the provided thenable resolves.

    Note: This function can only be called during event dispatch.

    Parameters

    • thenable: Thenable<any>

      A thenable that delays saving.

    Returns void