Options
All
  • Public
  • Public/Protected
  • All
Menu

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.

Hierarchy

  • FileWillCreateEvent

Index

Properties

Methods

Properties

Readonly files

files: readonly Uri[]

The files that are going to be created.

Methods

waitUntil

  • waitUntil(thenable: Thenable<WorkspaceEdit>): void
  • waitUntil(thenable: Thenable<any>): void
  • 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

    • thenable: Thenable<WorkspaceEdit>

      A thenable that delays saving.

    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