website/versioned_docs/version-v19.0.0/api-reference/relay-runtime/request-subscription.md
import DocsRating from '@site/src/core/DocsRating'; import {OssOnly, FbInternalOnly} from 'docusaurus-plugin-internaldocs-fb/internal'; import GraphQLSubscriptionConfig from '../types/GraphQLSubscriptionConfig.md'; import Disposable from '../types/Disposable.md';
requestSubscriptionImperative API for establishing a GraphQL Subscription.
See also the useSubscription API and the Guide to Updating Data.
import {graphql, requestSubscription} from 'react-relay';
const subscription = graphql`
subscription UserDataSubscription($input: InputData!) {
# ...
}
`;
function createSubscription(environment: IEnvironment): Disposable {
return requestSubscription(environment, {
subscription,
variables: {input: {userId: '4'}},
});
}
environment: A Relay Environmentconfig: GraphQLSubscriptionConfigDisposable that clears the subscription.