Altair GraphQL Client

Appearance

getOptions() ​

getOptions(opts: object): object

Parameters ​

• opts

• opts.cspNonce?: string= undefined

CSP nonce value to be used in Altair

• opts.disableAccount?: boolean= undefined

Disable the account and remote syncing functionality

• opts.endpointURL?: string= undefined

URL to set as the server endpoint

• opts.initialAuthorization?: object | object | object | object | object= undefined

Initial authorization type and data

• opts.initialEnvironments?= undefined

Initial Environments to be added

Example

ts
{
   *   activeSubEnvironment: 'sub-1'
   *   base: {
   *     title: 'Environment',
   *     variables: {}
   *   },
   *   subEnvironments: [
   *     {
   *       title: 'sub-1',
   *       variables: {}
   *     }
   *   ]
   * }

• opts.initialEnvironments.activeSubEnvironment?: string= undefined

• opts.initialEnvironments.base?= undefined

• opts.initialEnvironments.base.id?: string= undefined

• opts.initialEnvironments.base.title?: string= undefined

• opts.initialEnvironments.base.variables?: Record<string, unknown>= undefined

• opts.initialEnvironments.subEnvironments?: object[]= undefined

• opts.initialHeaders?: Record<string, unknown>= undefined

Initial headers object to be added

Example

ts
{
   *  'X-GraphQL-Token': 'asd7-237s-2bdk-nsdk4'
   * }

• opts.initialHttpMethod?: "POST" | "GET" | "PUT" | "DELETE"= undefined

Initial HTTP method to use for making requests

• opts.initialName?: string= undefined

Initial name of the window

• opts.initialPostRequestScript?: string= undefined

Initial post-request script to be added

• opts.initialPreRequestScript?: string= undefined

Initial pre-request script to be added

• opts.initialQuery?: string= undefined

Initial query to be added

• opts.initialRequestHandlerAdditionalParams?: Record<string, unknown>= undefined

Additional params to be passed to the request handler

• opts.initialRequestHandlerId?: "http" | "websocket" | "graphql-ws" | "app-sync" | "action-cable" | "graphql-sse"= undefined

Initial request handler id

Default

ts
"http"

• opts.initialSettings?= undefined

Initial app settings to use

• opts.initialSettings.addQueryDepthLimit?: number= undefined

Specifies how deep the 'Add query' functionality should go. You can specify any valid positive integer.

• opts.initialSettings.alert.disableUpdateNotification?: boolean= undefined

Disable update notification

• opts.initialSettings.alert.disableWarnings?: boolean= undefined

Disable warning alerts

• opts.initialSettings.banners.disable?: boolean= undefined

Disable banners

• opts.initialSettings.beta.disable.newEditor?: boolean= undefined

Disable new editor beta

• opts.initialSettings.beta.disable.newScript?: boolean= undefined

Disable new script beta

• opts.initialSettings.disableLineNumbers?: boolean= undefined

Disable line numbers

• opts.initialSettings.disablePushNotification?: boolean= undefined

Specifies if native push notifications should be disabled

Default

ts
false

• opts.initialSettings.doc.hideDeprecatedItems?: boolean= undefined

Hides deprecated Doc items

• opts.initialSettings.editor.shortcuts?: Record<string, string>= undefined

Contains shortcut to action mapping

• opts.initialSettings.enableExperimental?: boolean= undefined

Enable experimental features. Note: The features might be unstable

Default

ts
false

• opts.initialSettings.enableTablistScrollbar?: boolean= undefined

Enable the scrollbar in the tab list

• opts.initialSettings.historyDepth?: number= undefined

Number of items allowed in history pane

• opts.initialSettings.introspection.options.description?: boolean= undefined

Whether to include descriptions in the introspection result

• opts.initialSettings.introspection.options.directiveIsRepeatable?: boolean= undefined

Whether to include isRepeatable flag on directives

• opts.initialSettings.introspection.options.inputValueDeprecation?: boolean= undefined

Whether target GraphQL server supports deprecation of input values

• opts.initialSettings.introspection.options.schemaDescription?: boolean= undefined

Whether to include description field on schema

• opts.initialSettings.introspection.options.specifiedByUrl?: boolean= undefined

Whether to include specifiedByUrl in the introspection result

• opts.initialSettings.language?: "ach-UG" | "en-US" | "fr-FR" | "es-ES" | "cs-CZ" | "de-DE" | "pt-BR" | "ru-RU" | "uk-UA" | "zh-CN" | "ja-JP" | "sr-SP" | "it-IT" | "pl-PL" | "ko-KR" | "ro-RO" | "vi-VN"= undefined

Specifies the language

• opts.initialSettings.plugin.list?: string[]= undefined

Specifies a list of enabled plugins.

Plugins are specified in a string format <plugin-source>:<plugin-name>@<version>::[<opt>]->[<opt-value>]:

  • <plugin-source>: The source of the plugin. Can be 'npm', 'url' or 'github'
  • <plugin-name> (required): The name of the plugin. Plugin names must begin with altair-graphql-plugin-
  • <version>: The version of the plugin. If not specified, the latest version will be used
  • [<opt>]->[<opt-value>]: Additional configuration for the plugin. This is used when you specify the source as 'url'. In this case, you can specify the URL where the plugin is hosted.

Example

ts
['altair-graphql-plugin-some-plugin', 'npm:altair-graphql-plugin-some-plugin', 'npm:altair-graphql-plugin-some-plugin@0.3.4', 'url:altair-graphql-plugin-some-plugin@0.3.4::[url]->[http://example.com/some-plugin]']

Default

ts
[]

• opts.initialSettings.request.withCredentials?: boolean= undefined

Send requests with credentials (cookies)

• opts.initialSettings.response.hideExtensions?: boolean= undefined

Hides extensions object

• opts.initialSettings.response.stream.strategy?: AUTO | CONCATENATE | APPEND | PATCH= undefined

Determine the handling strategy for multiple responses

• opts.initialSettings.schema.reload.onEnvChange?: boolean= undefined

Reload schema when switching environments

• opts.initialSettings.schema.reloadOnStart?: boolean= undefined

Reload schema on app start

• opts.initialSettings.script.allowedCookies?: string[]= undefined

List of cookies to be accessible in the pre-request script

Example

ts
['cookie1', 'cookie2']

Default

ts
[]

• opts.initialSettings.script.allowedLocalStorageKeys?: string[]= undefined

List of local storage keys to be accessible in the pre-request script. These will be made available read-only via the storage API in the script context.

Example

ts
['key1', 'key2']

Default

ts
[]

• opts.initialSettings.tabSize?: number= undefined

Specifies the tab size for the editor

• opts.initialSettings.theme?: string= undefined

Specifies the theme. Themes available by default are 'light', 'dark', 'system', 'dracula'. Additional themes can be added via plugins.

Default

ts
'system'

• opts.initialSettings.theme.dark?: string= undefined

Specifies the theme for dark mode

• opts.initialSettings.theme.editorFontFamily?: string= undefined

Specifies the font family for the editors. Any valid CSS font family combination can be used here

• opts.initialSettings.theme.editorFontSize?: number= undefined

Specifies the font size for the editors

• opts.initialSettings.theme.fontsize?: number= undefined

Specifies the base font size

Default

ts
24

• opts.initialSettings.themeConfig?: object | object= undefined

Specify custom theme config to override the specified theme values

• opts.initialSettings.themeConfig.dark?: object | object= undefined

Theme config object for dark mode

• opts.initialSubscriptionRequestHandlerId?: "http" | "websocket" | "graphql-ws" | "app-sync" | "action-cable" | "graphql-sse"= undefined

Initial subscriptions provider

Default

ts
"websocket"

• opts.initialSubscriptionsPayload?: Record<string, unknown>= undefined

Initial subscriptions connection params

• opts.initialVariables?: string= undefined

Initial variables to be added

• opts.initialWindows?: object[]= undefined

List of options for windows to be loaded

• opts.instanceStorageNamespace?: string= undefined

Namespace for storing the data for the altair instance. Use this when you have multiple altair instances running on the same domain.

Example

ts
instanceStorageNamespace: 'altair_dev_'

• opts.persistedSettings?= undefined

Persisted settings for the app. The settings will be merged with the app settings.

• opts.persistedSettings.addQueryDepthLimit?: number= undefined

Specifies how deep the 'Add query' functionality should go. You can specify any valid positive integer.

• opts.persistedSettings.alert.disableUpdateNotification?: boolean= undefined

Disable update notification

• opts.persistedSettings.alert.disableWarnings?: boolean= undefined

Disable warning alerts

• opts.persistedSettings.banners.disable?: boolean= undefined

Disable banners

• opts.persistedSettings.beta.disable.newEditor?: boolean= undefined

Disable new editor beta

• opts.persistedSettings.beta.disable.newScript?: boolean= undefined

Disable new script beta

• opts.persistedSettings.disableLineNumbers?: boolean= undefined

Disable line numbers

• opts.persistedSettings.disablePushNotification?: boolean= undefined

Specifies if native push notifications should be disabled

Default

ts
false

• opts.persistedSettings.doc.hideDeprecatedItems?: boolean= undefined

Hides deprecated Doc items

• opts.persistedSettings.editor.shortcuts?: Record<string, string>= undefined

Contains shortcut to action mapping

• opts.persistedSettings.enableExperimental?: boolean= undefined

Enable experimental features. Note: The features might be unstable

Default

ts
false

• opts.persistedSettings.enableTablistScrollbar?: boolean= undefined

Enable the scrollbar in the tab list

• opts.persistedSettings.historyDepth?: number= undefined

Number of items allowed in history pane

• opts.persistedSettings.introspection.options.description?: boolean= undefined

Whether to include descriptions in the introspection result

• opts.persistedSettings.introspection.options.directiveIsRepeatable?: boolean= undefined

Whether to include isRepeatable flag on directives

• opts.persistedSettings.introspection.options.inputValueDeprecation?: boolean= undefined

Whether target GraphQL server supports deprecation of input values

• opts.persistedSettings.introspection.options.schemaDescription?: boolean= undefined

Whether to include description field on schema

• opts.persistedSettings.introspection.options.specifiedByUrl?: boolean= undefined

Whether to include specifiedByUrl in the introspection result

• opts.persistedSettings.language?: "ach-UG" | "en-US" | "fr-FR" | "es-ES" | "cs-CZ" | "de-DE" | "pt-BR" | "ru-RU" | "uk-UA" | "zh-CN" | "ja-JP" | "sr-SP" | "it-IT" | "pl-PL" | "ko-KR" | "ro-RO" | "vi-VN"= undefined

Specifies the language

• opts.persistedSettings.plugin.list?: string[]= undefined

Specifies a list of enabled plugins.

Plugins are specified in a string format <plugin-source>:<plugin-name>@<version>::[<opt>]->[<opt-value>]:

  • <plugin-source>: The source of the plugin. Can be 'npm', 'url' or 'github'
  • <plugin-name> (required): The name of the plugin. Plugin names must begin with altair-graphql-plugin-
  • <version>: The version of the plugin. If not specified, the latest version will be used
  • [<opt>]->[<opt-value>]: Additional configuration for the plugin. This is used when you specify the source as 'url'. In this case, you can specify the URL where the plugin is hosted.

Example

ts
['altair-graphql-plugin-some-plugin', 'npm:altair-graphql-plugin-some-plugin', 'npm:altair-graphql-plugin-some-plugin@0.3.4', 'url:altair-graphql-plugin-some-plugin@0.3.4::[url]->[http://example.com/some-plugin]']

Default

ts
[]

• opts.persistedSettings.request.withCredentials?: boolean= undefined

Send requests with credentials (cookies)

• opts.persistedSettings.response.hideExtensions?: boolean= undefined

Hides extensions object

• opts.persistedSettings.response.stream.strategy?: AUTO | CONCATENATE | APPEND | PATCH= undefined

Determine the handling strategy for multiple responses

• opts.persistedSettings.schema.reload.onEnvChange?: boolean= undefined

Reload schema when switching environments

• opts.persistedSettings.schema.reloadOnStart?: boolean= undefined

Reload schema on app start

• opts.persistedSettings.script.allowedCookies?: string[]= undefined

List of cookies to be accessible in the pre-request script

Example

ts
['cookie1', 'cookie2']

Default

ts
[]

• opts.persistedSettings.script.allowedLocalStorageKeys?: string[]= undefined

List of local storage keys to be accessible in the pre-request script. These will be made available read-only via the storage API in the script context.

Example

ts
['key1', 'key2']

Default

ts
[]

• opts.persistedSettings.tabSize?: number= undefined

Specifies the tab size for the editor

• opts.persistedSettings.theme?: string= undefined

Specifies the theme. Themes available by default are 'light', 'dark', 'system', 'dracula'. Additional themes can be added via plugins.

Default

ts
'system'

• opts.persistedSettings.theme.dark?: string= undefined

Specifies the theme for dark mode

• opts.persistedSettings.theme.editorFontFamily?: string= undefined

Specifies the font family for the editors. Any valid CSS font family combination can be used here

• opts.persistedSettings.theme.editorFontSize?: number= undefined

Specifies the font size for the editors

• opts.persistedSettings.theme.fontsize?: number= undefined

Specifies the base font size

Default

ts
24

• opts.persistedSettings.themeConfig?: object | object= undefined

Specify custom theme config to override the specified theme values

• opts.persistedSettings.themeConfig.dark?: object | object= undefined

Theme config object for dark mode

• opts.preserveState?: boolean= undefined

Indicates if the state should be preserved for subsequent app loads

Default

ts
true

• opts.subscriptionsEndpoint?: string= undefined

URL to set as the subscription endpoint. This can be relative or absolute.

• opts.subscriptionsProtocol?: string= undefined

URL protocol for the subscription endpoint. This is used if the specified subscriptions endpoint is relative. e.g. wss

Returns ​

object

cspNonce ​

cspNonce: string = ''

CSP nonce value to be used in Altair

disableAccount ​

disableAccount: boolean = false

Disable the account and remote syncing functionality

endpointURL? ​

optional endpointURL: string

URL to set as the server endpoint

initialAuthorization? ​

optional initialAuthorization: object | object | object | object | object

Initial authorization type and data

initialEnvironments? ​

optional initialEnvironments: object

Initial Environments to be added

Example ​

ts
{
   *   activeSubEnvironment: 'sub-1'
   *   base: {
   *     title: 'Environment',
   *     variables: {}
   *   },
   *   subEnvironments: [
   *     {
   *       title: 'sub-1',
   *       variables: {}
   *     }
   *   ]
   * }

initialEnvironments.activeSubEnvironment? ​

optional activeSubEnvironment: string

initialEnvironments.base? ​

optional base: object

initialEnvironments.base.id? ​

optional id: string

initialEnvironments.base.title? ​

optional title: string

initialEnvironments.base.variables? ​

optional variables: Record<string, unknown>

initialEnvironments.subEnvironments? ​

optional subEnvironments: object[]

initialHeaders? ​

optional initialHeaders: Record<string, unknown>

Initial headers object to be added

Example ​

ts
{
   *  'X-GraphQL-Token': 'asd7-237s-2bdk-nsdk4'
   * }

initialHttpMethod ​

initialHttpMethod: "POST" | "GET" | "PUT" | "DELETE" = httpVerbSchema.enum.POST

Initial HTTP method to use for making requests

initialName? ​

optional initialName: string

Initial name of the window

initialPostRequestScript ​

initialPostRequestScript: string = ''

Initial post-request script to be added

initialPreRequestScript? ​

optional initialPreRequestScript: string

Initial pre-request script to be added

initialQuery? ​

optional initialQuery: string

Initial query to be added

initialRequestHandlerAdditionalParams ​

initialRequestHandlerAdditionalParams: object = {}

Additional params to be passed to the request handler

initialRequestHandlerId ​

initialRequestHandlerId: "http" | "websocket" | "graphql-ws" | "app-sync" | "action-cable" | "graphql-sse" = HTTP_HANDLER_ID

Initial request handler id

Default ​

ts
"http"

initialSettings? ​

optional initialSettings: object

Initial app settings to use

initialSettings.addQueryDepthLimit? ​

optional addQueryDepthLimit: number

Specifies how deep the 'Add query' functionality should go. You can specify any valid positive integer.

initialSettings.alert.disableUpdateNotification? ​

optional initialSettings.alert.disableUpdateNotification: boolean

Disable update notification

initialSettings.alert.disableWarnings? ​

optional initialSettings.alert.disableWarnings: boolean

Disable warning alerts

initialSettings.banners.disable? ​

optional initialSettings.banners.disable: boolean

Disable banners

initialSettings.beta.disable.newEditor? ​

optional initialSettings.beta.disable.newEditor: boolean

Disable new editor beta

initialSettings.beta.disable.newScript? ​

optional initialSettings.beta.disable.newScript: boolean

Disable new script beta

initialSettings.disableLineNumbers? ​

optional disableLineNumbers: boolean

Disable line numbers

initialSettings.disablePushNotification? ​

optional disablePushNotification: boolean

Specifies if native push notifications should be disabled

Default ​

ts
false

initialSettings.doc.hideDeprecatedItems? ​

optional initialSettings.doc.hideDeprecatedItems: boolean

Hides deprecated Doc items

initialSettings.editor.shortcuts? ​

optional initialSettings.editor.shortcuts: Record<string, string>

Contains shortcut to action mapping

initialSettings.enableExperimental? ​

optional enableExperimental: boolean

Enable experimental features. Note: The features might be unstable

Default ​

ts
false

initialSettings.enableTablistScrollbar? ​

optional enableTablistScrollbar: boolean

Enable the scrollbar in the tab list

initialSettings.historyDepth? ​

optional historyDepth: number

Number of items allowed in history pane

initialSettings.introspection.options.description? ​

optional initialSettings.introspection.options.description: boolean

Whether to include descriptions in the introspection result

initialSettings.introspection.options.directiveIsRepeatable? ​

optional initialSettings.introspection.options.directiveIsRepeatable: boolean

Whether to include isRepeatable flag on directives

initialSettings.introspection.options.inputValueDeprecation? ​

optional initialSettings.introspection.options.inputValueDeprecation: boolean

Whether target GraphQL server supports deprecation of input values

initialSettings.introspection.options.schemaDescription? ​

optional initialSettings.introspection.options.schemaDescription: boolean

Whether to include description field on schema

initialSettings.introspection.options.specifiedByUrl? ​

optional initialSettings.introspection.options.specifiedByUrl: boolean

Whether to include specifiedByUrl in the introspection result

initialSettings.language? ​

optional language: "ach-UG" | "en-US" | "fr-FR" | "es-ES" | "cs-CZ" | "de-DE" | "pt-BR" | "ru-RU" | "uk-UA" | "zh-CN" | "ja-JP" | "sr-SP" | "it-IT" | "pl-PL" | "ko-KR" | "ro-RO" | "vi-VN"

Specifies the language

initialSettings.plugin.list? ​

optional initialSettings.plugin.list: string[]

Specifies a list of enabled plugins.

Plugins are specified in a string format <plugin-source>:<plugin-name>@<version>::[<opt>]->[<opt-value>]:

  • <plugin-source>: The source of the plugin. Can be 'npm', 'url' or 'github'
  • <plugin-name> (required): The name of the plugin. Plugin names must begin with altair-graphql-plugin-
  • <version>: The version of the plugin. If not specified, the latest version will be used
  • [<opt>]->[<opt-value>]: Additional configuration for the plugin. This is used when you specify the source as 'url'. In this case, you can specify the URL where the plugin is hosted.

Example ​

ts
['altair-graphql-plugin-some-plugin', 'npm:altair-graphql-plugin-some-plugin', 'npm:altair-graphql-plugin-some-plugin@0.3.4', 'url:altair-graphql-plugin-some-plugin@0.3.4::[url]->[http://example.com/some-plugin]']

Default ​

ts
[]

initialSettings.request.withCredentials? ​

optional initialSettings.request.withCredentials: boolean

Send requests with credentials (cookies)

initialSettings.response.hideExtensions? ​

optional initialSettings.response.hideExtensions: boolean

Hides extensions object

initialSettings.response.stream.strategy? ​

optional initialSettings.response.stream.strategy: AUTO | CONCATENATE | APPEND | PATCH

Determine the handling strategy for multiple responses

initialSettings.schema.reload.onEnvChange? ​

optional initialSettings.schema.reload.onEnvChange: boolean

Reload schema when switching environments

initialSettings.schema.reloadOnStart? ​

optional initialSettings.schema.reloadOnStart: boolean

Reload schema on app start

initialSettings.script.allowedCookies? ​

optional initialSettings.script.allowedCookies: string[]

List of cookies to be accessible in the pre-request script

Example ​

ts
['cookie1', 'cookie2']

Default ​

ts
[]

initialSettings.script.allowedLocalStorageKeys? ​

optional initialSettings.script.allowedLocalStorageKeys: string[]

List of local storage keys to be accessible in the pre-request script. These will be made available read-only via the storage API in the script context.

Example ​

ts
['key1', 'key2']

Default ​

ts
[]

initialSettings.tabSize? ​

optional tabSize: number

Specifies the tab size for the editor

initialSettings.theme? ​

optional theme: string

Specifies the theme. Themes available by default are 'light', 'dark', 'system', 'dracula'. Additional themes can be added via plugins.

Default ​

ts
'system'

initialSettings.theme.dark? ​

optional initialSettings.theme.dark: string

Specifies the theme for dark mode

initialSettings.theme.editorFontFamily? ​

optional initialSettings.theme.editorFontFamily: string

Specifies the font family for the editors. Any valid CSS font family combination can be used here

initialSettings.theme.editorFontSize? ​

optional initialSettings.theme.editorFontSize: number

Specifies the font size for the editors

initialSettings.theme.fontsize? ​

optional initialSettings.theme.fontsize: number

Specifies the base font size

Default ​

ts
24

initialSettings.themeConfig? ​

optional themeConfig: object | object

Specify custom theme config to override the specified theme values

initialSettings.themeConfig.dark? ​

optional initialSettings.themeConfig.dark: object | object

Theme config object for dark mode

initialSubscriptionRequestHandlerId ​

initialSubscriptionRequestHandlerId: "http" | "websocket" | "graphql-ws" | "app-sync" | "action-cable" | "graphql-sse" = WEBSOCKET_HANDLER_ID

Initial subscriptions provider

Default ​

ts
"websocket"

initialSubscriptionsPayload? ​

optional initialSubscriptionsPayload: Record<string, unknown>

Initial subscriptions connection params

initialVariables? ​

optional initialVariables: string

Initial variables to be added

initialWindows ​

initialWindows: object[] = []

List of options for windows to be loaded

instanceStorageNamespace ​

instanceStorageNamespace: string = 'altair_'

Namespace for storing the data for the altair instance. Use this when you have multiple altair instances running on the same domain.

Example ​

ts
instanceStorageNamespace: 'altair_dev_'

persistedSettings? ​

optional persistedSettings: object

Persisted settings for the app. The settings will be merged with the app settings.

persistedSettings.addQueryDepthLimit? ​

optional addQueryDepthLimit: number

Specifies how deep the 'Add query' functionality should go. You can specify any valid positive integer.

persistedSettings.alert.disableUpdateNotification? ​

optional persistedSettings.alert.disableUpdateNotification: boolean

Disable update notification

persistedSettings.alert.disableWarnings? ​

optional persistedSettings.alert.disableWarnings: boolean

Disable warning alerts

persistedSettings.banners.disable? ​

optional persistedSettings.banners.disable: boolean

Disable banners

persistedSettings.beta.disable.newEditor? ​

optional persistedSettings.beta.disable.newEditor: boolean

Disable new editor beta

persistedSettings.beta.disable.newScript? ​

optional persistedSettings.beta.disable.newScript: boolean

Disable new script beta

persistedSettings.disableLineNumbers? ​

optional disableLineNumbers: boolean

Disable line numbers

persistedSettings.disablePushNotification? ​

optional disablePushNotification: boolean

Specifies if native push notifications should be disabled

Default ​

ts
false

persistedSettings.doc.hideDeprecatedItems? ​

optional persistedSettings.doc.hideDeprecatedItems: boolean

Hides deprecated Doc items

persistedSettings.editor.shortcuts? ​

optional persistedSettings.editor.shortcuts: Record<string, string>

Contains shortcut to action mapping

persistedSettings.enableExperimental? ​

optional enableExperimental: boolean

Enable experimental features. Note: The features might be unstable

Default ​

ts
false

persistedSettings.enableTablistScrollbar? ​

optional enableTablistScrollbar: boolean

Enable the scrollbar in the tab list

persistedSettings.historyDepth? ​

optional historyDepth: number

Number of items allowed in history pane

persistedSettings.introspection.options.description? ​

optional persistedSettings.introspection.options.description: boolean

Whether to include descriptions in the introspection result

persistedSettings.introspection.options.directiveIsRepeatable? ​

optional persistedSettings.introspection.options.directiveIsRepeatable: boolean

Whether to include isRepeatable flag on directives

persistedSettings.introspection.options.inputValueDeprecation? ​

optional persistedSettings.introspection.options.inputValueDeprecation: boolean

Whether target GraphQL server supports deprecation of input values

persistedSettings.introspection.options.schemaDescription? ​

optional persistedSettings.introspection.options.schemaDescription: boolean

Whether to include description field on schema

persistedSettings.introspection.options.specifiedByUrl? ​

optional persistedSettings.introspection.options.specifiedByUrl: boolean

Whether to include specifiedByUrl in the introspection result

persistedSettings.language? ​

optional language: "ach-UG" | "en-US" | "fr-FR" | "es-ES" | "cs-CZ" | "de-DE" | "pt-BR" | "ru-RU" | "uk-UA" | "zh-CN" | "ja-JP" | "sr-SP" | "it-IT" | "pl-PL" | "ko-KR" | "ro-RO" | "vi-VN"

Specifies the language

persistedSettings.plugin.list? ​

optional persistedSettings.plugin.list: string[]

Specifies a list of enabled plugins.

Plugins are specified in a string format <plugin-source>:<plugin-name>@<version>::[<opt>]->[<opt-value>]:

  • <plugin-source>: The source of the plugin. Can be 'npm', 'url' or 'github'
  • <plugin-name> (required): The name of the plugin. Plugin names must begin with altair-graphql-plugin-
  • <version>: The version of the plugin. If not specified, the latest version will be used
  • [<opt>]->[<opt-value>]: Additional configuration for the plugin. This is used when you specify the source as 'url'. In this case, you can specify the URL where the plugin is hosted.

Example ​

ts
['altair-graphql-plugin-some-plugin', 'npm:altair-graphql-plugin-some-plugin', 'npm:altair-graphql-plugin-some-plugin@0.3.4', 'url:altair-graphql-plugin-some-plugin@0.3.4::[url]->[http://example.com/some-plugin]']

Default ​

ts
[]

persistedSettings.request.withCredentials? ​

optional persistedSettings.request.withCredentials: boolean

Send requests with credentials (cookies)

persistedSettings.response.hideExtensions? ​

optional persistedSettings.response.hideExtensions: boolean

Hides extensions object

persistedSettings.response.stream.strategy? ​

optional persistedSettings.response.stream.strategy: AUTO | CONCATENATE | APPEND | PATCH

Determine the handling strategy for multiple responses

persistedSettings.schema.reload.onEnvChange? ​

optional persistedSettings.schema.reload.onEnvChange: boolean

Reload schema when switching environments

persistedSettings.schema.reloadOnStart? ​

optional persistedSettings.schema.reloadOnStart: boolean

Reload schema on app start

persistedSettings.script.allowedCookies? ​

optional persistedSettings.script.allowedCookies: string[]

List of cookies to be accessible in the pre-request script

Example ​

ts
['cookie1', 'cookie2']

Default ​

ts
[]

persistedSettings.script.allowedLocalStorageKeys? ​

optional persistedSettings.script.allowedLocalStorageKeys: string[]

List of local storage keys to be accessible in the pre-request script. These will be made available read-only via the storage API in the script context.

Example ​

ts
['key1', 'key2']

Default ​

ts
[]

persistedSettings.tabSize? ​

optional tabSize: number

Specifies the tab size for the editor

persistedSettings.theme? ​

optional theme: string

Specifies the theme. Themes available by default are 'light', 'dark', 'system', 'dracula'. Additional themes can be added via plugins.

Default ​

ts
'system'

persistedSettings.theme.dark? ​

optional persistedSettings.theme.dark: string

Specifies the theme for dark mode

persistedSettings.theme.editorFontFamily? ​

optional persistedSettings.theme.editorFontFamily: string

Specifies the font family for the editors. Any valid CSS font family combination can be used here

persistedSettings.theme.editorFontSize? ​

optional persistedSettings.theme.editorFontSize: number

Specifies the font size for the editors

persistedSettings.theme.fontsize? ​

optional persistedSettings.theme.fontsize: number

Specifies the base font size

Default ​

ts
24

persistedSettings.themeConfig? ​

optional themeConfig: object | object

Specify custom theme config to override the specified theme values

persistedSettings.themeConfig.dark? ​

optional persistedSettings.themeConfig.dark: object | object

Theme config object for dark mode

preserveState ​

preserveState: boolean = true

Indicates if the state should be preserved for subsequent app loads

Default ​

ts
true

subscriptionsEndpoint? ​

optional subscriptionsEndpoint: string

URL to set as the subscription endpoint. This can be relative or absolute.

subscriptionsProtocol? ​

optional subscriptionsProtocol: string

URL protocol for the subscription endpoint. This is used if the specified subscriptions endpoint is relative. e.g. wss