BaseHttpLink
Get GraphQL results over a network using HTTP fetch
BaseHttpLink is a terminating link that sends a GraphQL operation to a remote endpoint over HTTP. It serves as a base link to HttpLink.
BaseHttpLink supports both POST and GET requests, and you can configure HTTP options on a per-operation basis. You can use these options for authentication, persisted queries, dynamic URIs, and other granular updates.
HttpLink over BaseHttpLink. Use BaseHttpLink when you need to disable client awareness features and would like to tree-shake the implementation of ClientAwarenessLink out of your app bundle.1 import { BaseHttpLink } from "@apollo/client/link/http"; 2 3 const link = new BaseHttpLink({ 4 uri: "http://localhost:4000/graphql", 5 headers: { 6 authorization: `Bearer ${token}`, 7 }, 8 });Constructor signature
1constructor( 2 options: BaseHttpLink.Options = {} 3): BaseHttpLinkUsage
See the HttpLink documentation for more information on how to use BaseHttpLink.
Types
Options passed to BaseHttpLink through request context. Previous non-terminating links in the link chain also can set these values to customize the behavior of BaseHttpLink for each operation.
HttpLink constructor. If a value is provided to both, the value in context takes precedence.RequestCredentialsThe credentials policy to use for each fetch call.
RequestInitAny overrides of the fetch options argument to pass to the fetch call.
An object containing options to use for each call to fetch. If a particular option is not included in this object, the default value of that option is used.
Record<string, string>An object representing headers to include in every HTTP request.
1 { 2 "Authorization": "Bearer 1234" 3 }BaseHttpLink.HttpOptionsAn object that configures advanced functionality, such as support for persisted queries.
string | BaseHttpLink.UriFunctionThe URL of the GraphQL endpoint to send requests to. Can also be a function that accepts an ApolloLink.Operation object and returns the string URL to use for that operation.
Options passed to BaseHttpLink through the http property of a request context.
string[]A list of additional accept headers to include in the request, as defined in https://datatracker.ietf.org/doc/html/rfc7231#section-5.3.2
1 ["application/custom+json;q=1.0"]booleanIf true, includes the extensions field in operations sent to your GraphQL endpoint.
booleanIf false, the GraphQL query string is not included in the request. Set this option if you're sending a request that uses a persisted query.
booleanIf true, header names won't be automatically normalized to lowercase. This allows for non-http-spec-compliant servers that might expect capitalized header names.
Options provided to the BaseHttpLink constructor.
RequestCredentialsThe credentials policy to use for each fetch call.
typeof fetchA function to use instead of calling the Fetch API directly when sending HTTP requests to your GraphQL endpoint. The function must conform to the signature of fetch.
By default, the Fetch API is used unless it isn't available in your runtime environment.
See Customizing fetch.
RequestInitAny overrides of the fetch options argument to pass to the fetch call.
An object containing options to use for each call to fetch. If a particular option is not included in this object, the default value of that option is used.
Record<string, string>An object representing headers to include in every HTTP request.
1 { 2 "Authorization": "Bearer 1234" 3 }booleanIf true, includes the extensions field in operations sent to your GraphQL endpoint.
If true, unused variables from the operation will not be stripped from the request and will instead be sent to the GraphQL endpoint.
Read more...
Unused variables are likely to trigger server-side validation errors, per https://spec.graphql.org/draft/#sec-All-Variables-Used. includeUnusedVariables can be useful if your server deviates from the GraphQL specification by not strictly enforcing that rule.
booleanIf true, header names won't be automatically normalized to lowercase. This allows for non-http-spec-compliant servers that might expect capitalized header names.
BaseHttpLink.PrinterA function to use when transforming a GraphQL document into a string. It accepts an ASTNode (typically a DocumentNode) and the original print function as arguments, and is expected to return a string. This option enables you to, for example, use stripIgnoredCharacters to remove whitespace from queries.
By default the GraphQL print function is used.
1 import { stripIgnoredCharacters } from "graphql"; 2 3 const httpLink = new HttpLink({ 4 uri: "/graphql", 5 print: (ast, originalPrint) => stripIgnoredCharacters(originalPrint(ast)), 6 });string | BaseHttpLink.UriFunctionThe URL of the GraphQL endpoint to send requests to. Can also be a function that accepts an ApolloLink.Operation object and returns the string URL to use for that operation.
booleanIf true, the link uses an HTTP GET request when sending query operations to your GraphQL endpoint. Mutation operations continue to use POST requests. If you want all operations to use GET requests, set fetchOptions.method instead.