The document formatting provider interface defines the contract between extensions and the formatting-feature.

Fields

provideOnTypeFormattingEdits(document:TextDocument, position:Position, ch:String, options:FormattingOptions, token:CancellationToken):ProviderResult<Array<TextEdit>>

Provide formatting edits after a character has been typed.

The given position and character should hint to the provider what range the position to expand to, like find the matching { when } has been entered.

Parameters:

document

The document in which the command was invoked.

position

The position at which the command was invoked.

ch

The character that has been typed.

options

Options controlling formatting.

token

A cancellation token.

Returns:

A set of text edits or a thenable that resolves to such. The lack of a result can be signaled by returning undefined, null, or an empty array.