playground

Documentation

Index

• func AltairHandler(title, endpoint string, options map[string]any) http.HandlerFunc
• func ApolloSandboxHandler(title, endpoint string, opts ...ApolloSandboxOption) http.HandlerFunc
• func Handler(title, endpoint string, opts ...GraphiqlConfigOption) http.HandlerFunc
• func HandlerWithHeaders(title, endpoint string, fetcherHeaders, uiHeaders map[string]string) http.HandlerFunc
• type ApolloSandboxOption
  • func WithApolloSandboxEndpointIsEditable(endpointIsEditable bool) ApolloSandboxOption
  • func WithApolloSandboxHideCookieToggle(hideCookieToggle bool) ApolloSandboxOption
  • func WithApolloSandboxInitialStateCollectionIdAndOperationId(collectionId, operationId string) ApolloSandboxOption
  • func WithApolloSandboxInitialStateDocument(document string) ApolloSandboxOption
  • func WithApolloSandboxInitialStateHeaders(headers map[string]any) ApolloSandboxOption
  • func WithApolloSandboxInitialStateIncludeCookies(includeCookies bool) ApolloSandboxOption
  • func WithApolloSandboxInitialStatePollForSchemaUpdates(pollForSchemaUpdates bool) ApolloSandboxOption
  • func WithApolloSandboxInitialStateSharedHeaders(sharedHeaders map[string]any) ApolloSandboxOption
  • func WithApolloSandboxInitialStateVariables(variables map[string]any) ApolloSandboxOption
  • func WithApolloSandboxJs(mainJs, mainSri string) ApolloSandboxOption
• type GraphiqlConfig
• type GraphiqlConfigOption
  • func WithGraphiqlEnablePluginExplorer(enable bool) GraphiqlConfigOption
  • func WithGraphiqlFetcherHeaders(headers map[string]string) GraphiqlConfigOption
  • func WithGraphiqlPluginExplorerVersion(jsUrl, cssUrl, jsSri, cssSri string) GraphiqlConfigOption
  • func WithGraphiqlReactVersion(reactJsUrl, reactDomJsUrl, reactJsSri, reactDomJsSri string) GraphiqlConfigOption
  • func WithGraphiqlUiHeaders(headers map[string]string) GraphiqlConfigOption
  • func WithGraphiqlVersion(jsUrl, cssUrl, jsSri, cssSri string) GraphiqlConfigOption
  • func WithStoragePrefix(prefix string) GraphiqlConfigOption

Functions

func AltairHandler

func AltairHandler(title, endpoint string, options map[string]any) http.HandlerFunc

AltairHandler responsible for setting up the altair playground

func ApolloSandboxHandler

func ApolloSandboxHandler(title, endpoint string, opts ...ApolloSandboxOption) http.HandlerFunc

ApolloSandboxHandler responsible for setting up the apollo sandbox playground

func Handler

func Handler(title, endpoint string, opts ...GraphiqlConfigOption) http.HandlerFunc

Handler responsible for setting up the playground

func HandlerWithHeaders

func HandlerWithHeaders(
	title, endpoint string,
	fetcherHeaders, uiHeaders map[string]string,
) http.HandlerFunc

HandlerWithHeaders sets up the playground. fetcherHeaders are used by the playground's fetcher instance and will not be visible in the UI. uiHeaders are default headers that will show up in the UI headers editor.

Types

type ApolloSandboxOption

type ApolloSandboxOption func(options *apolloSandboxHandlerOptions)

func WithApolloSandboxEndpointIsEditable

func WithApolloSandboxEndpointIsEditable(endpointIsEditable bool) ApolloSandboxOption

WithApolloSandboxEndpointIsEditable By default, the embedded Sandbox has a URL input box that is editable by users.

Set endpointIsEditable to false to prevent users of your embedded Sandbox instance from changing the endpoint URL.

func WithApolloSandboxHideCookieToggle

func WithApolloSandboxHideCookieToggle(hideCookieToggle bool) ApolloSandboxOption

WithApolloSandboxHideCookieToggle By default, the embedded Sandbox does not show the Include cookies toggle in its connection settings.

Set hideCookieToggle to false to enable users of your embedded Sandbox instance to toggle the Include cookies setting.

func WithApolloSandboxInitialStateCollectionIdAndOperationId

func WithApolloSandboxInitialStateCollectionIdAndOperationId(
	collectionId, operationId string,
) ApolloSandboxOption

WithApolloSandboxInitialStateCollectionIdAndOperationId The ID of a collection, paired with an operation ID to populate in the Sandbox on load.

You can find these values from a registered graph in Studio by clicking the ... menu next to an operation in the Explorer of that graph and selecting View operation details.

func WithApolloSandboxInitialStateDocument

func WithApolloSandboxInitialStateDocument(document string) ApolloSandboxOption

WithApolloSandboxInitialStateDocument Document operation to populate in the Sandbox's editor on load.

If you omit this, the Sandbox initially loads an example query based on your schema.

func WithApolloSandboxInitialStateHeaders

func WithApolloSandboxInitialStateHeaders(headers map[string]any) ApolloSandboxOption

WithApolloSandboxInitialStateHeaders Headers containing initial variable values to populate in the Sandbox on load.

If provided, these variables should apply to the initial query you provide for document.

func WithApolloSandboxInitialStateIncludeCookies

func WithApolloSandboxInitialStateIncludeCookies(includeCookies bool) ApolloSandboxOption

WithApolloSandboxInitialStateIncludeCookies Set this value to true if you want the Sandbox to pass { credentials: 'include' } for its requests by default.

If you set hideCookieToggle to false, users can override this default setting with the Include cookies toggle. (By default, the embedded Sandbox does not show the Include cookies toggle in its connection settings.)

If you also pass the handleRequest option, this option is ignored.

Read more about the fetch API and credentials here https://developer.mozilla.org/en-US/docs/Web/API/fetch#credentials

func WithApolloSandboxInitialStatePollForSchemaUpdates

func WithApolloSandboxInitialStatePollForSchemaUpdates(
	pollForSchemaUpdates bool,
) ApolloSandboxOption

WithApolloSandboxInitialStatePollForSchemaUpdates If true, the embedded Sandbox periodically polls your initialEndpoint for schema updates.

The default value is false.

func WithApolloSandboxInitialStateSharedHeaders

func WithApolloSandboxInitialStateSharedHeaders(sharedHeaders map[string]any) ApolloSandboxOption

WithApolloSandboxInitialStateSharedHeaders Headers that are applied by default to every operation executed by the embedded Sandbox.

Users can disable the application of these headers, but they can't modify their values.

The embedded Sandbox always includes these headers in its introspection queries to your initialEndpoint.

func WithApolloSandboxInitialStateVariables

func WithApolloSandboxInitialStateVariables(variables map[string]any) ApolloSandboxOption

WithApolloSandboxInitialStateVariables Variables containing initial variable values to populate in the Sandbox on load.

If provided, these variables should apply to the initial query you provide for document.

func WithApolloSandboxJs

func WithApolloSandboxJs(mainJs, mainSri string) ApolloSandboxOption

WithApolloSandboxJs The main javascript resource and its subresource integrity checksum

You can change the version of apollo sandbox.

type GraphiqlConfig

type GraphiqlConfig struct {
	Title                string
	StoragePrefix        string
	Endpoint             string
	FetcherHeaders       map[string]string
	UiHeaders            map[string]string
	EndpointIsAbsolute   bool
	SubscriptionEndpoint string
	JsUrl                template.URL
	JsSRI                string
	CssUrl               template.URL
	CssSRI               string
	ReactUrl             template.URL
	ReactSRI             string
	ReactDOMUrl          template.URL
	ReactDOMSRI          string
	EnablePluginExplorer bool
	PluginExplorerJsUrl  template.URL
	PluginExplorerJsSRI  string
	PluginExplorerCssUrl template.URL
	PluginExplorerCssSRI string
}

type GraphiqlConfigOption

type GraphiqlConfigOption func(*GraphiqlConfig)

func WithGraphiqlEnablePluginExplorer

func WithGraphiqlEnablePluginExplorer(enable bool) GraphiqlConfigOption

func WithGraphiqlFetcherHeaders

func WithGraphiqlFetcherHeaders(headers map[string]string) GraphiqlConfigOption

func WithGraphiqlPluginExplorerVersion

func WithGraphiqlPluginExplorerVersion(jsUrl, cssUrl, jsSri, cssSri string) GraphiqlConfigOption

func WithGraphiqlReactVersion

func WithGraphiqlReactVersion(
	reactJsUrl, reactDomJsUrl, reactJsSri, reactDomJsSri string,
) GraphiqlConfigOption

func WithGraphiqlUiHeaders

func WithGraphiqlUiHeaders(headers map[string]string) GraphiqlConfigOption

func WithGraphiqlVersion

func WithGraphiqlVersion(jsUrl, cssUrl, jsSri, cssSri string) GraphiqlConfigOption

func WithStoragePrefix

func WithStoragePrefix(prefix string) GraphiqlConfigOption