Class DefaultsPreferenceProvider

constructor

• new DefaultsPreferenceProvider(): DefaultsPreferenceProvider

  Returns DefaultsPreferenceProvider

ready

canHandleScope

• canHandleScope(scope: PreferenceScope): boolean

  Whether t

  Parameters

  • scope: PreferenceScope

    the scope to handle

  Returns boolean

get

• get<T>(preferenceName: string, resourceUri?: string): undefined | T

  Retrieve the stored value for the given preference and resource URI.

  Type Parameters

  • T

  Parameters

  • preferenceName: string

    the preference identifier.

  • OptionalresourceUri: string

    the uri of the resource for which the preference is stored. This is used to retrieve a potentially different value for the same preference for different resources, for example files.encoding.

  Returns undefined | T

  the value stored for the given preference and resourceUri if it exists, otherwise undefined.

getPreferences

• getPreferences(): JSONObject

  Return a JSONObject with all preferences stored in this preference provider

  Returns JSONObject

init

• init(): void

  Returns void

resolve

• resolve<T>(
      preferenceName: string,
      resourceUri?: string,
  ): PreferenceResolveResult<T>

  Resolve the value for the given preference and resource URI.

  Type Parameters

  • T

  Parameters

  • preferenceName: string

    the preference identifier.

  • OptionalresourceUri: string

    the URI of the resource for which this provider should resolve the preference. This is used to retrieve a potentially different value for the same preference for different resources, for example files.encoding.

  Returns PreferenceResolveResult<T>

  an object containing the value stored for the given preference and resourceUri if it exists, otherwise undefined.

setPreference

• setPreference(
      key: string,
      value: JSONValue,
      resourceUri?: string,
  ): Promise<boolean>

  Stores a new value for the given preference key in the provider.

  Parameters

  • key: string

    the preference key (typically the name).

  • value: JSONValue

    the new preference value.

  • OptionalresourceUri: string

    the URI of the resource for which the preference is stored.

  Returns Promise<boolean>

  a promise that only resolves if all changes were delivered. If changes were made then implementation must either await on this.emitPreferencesChangedEvent(...) or this.pendingChanges if changes are fired indirectly.