Function useQuery

packages/graphql-hooks/src/useQuery.ts:20–132

(
  query: string | TypedDocumentNode<ResponseData, Variables>,
  opts: UseQueryOptions<ResponseData, Variables, TRefetchData, TRefetchVariables> = {}
)

}

function useQuery<
  ResponseData = any,
  Variables = object,
  TGraphQLError extends GraphQLResponseError = GraphQLResponseError,
  TRefetchData = any,
  TRefetchVariables = object
>(
  query: string | TypedDocumentNode<ResponseData, Variables>,
  opts: UseQueryOptions<ResponseData, Variables, TRefetchData, TRefetchVariables> = {}
): UseQueryResult<ResponseData, Variables, TGraphQLError> {
  const allOpts = {
    ...defaultOpts,
    ...opts
  }
  const contextClient = React.useContext(ClientContext)
  const client = opts.client || contextClient
  const [calledDuringSSR, setCalledDuringSSR] = React.useState(false)
  const [queryReq, state] = useClientRequest<
    ResponseData,
    Variables,
    TGraphQLError
  >(query, allOpts)

  if (!client) {
    throw new Error(
      'useQuery() requires a client to be passed in the options or as a context value'
    )
  }

  if (
    client.ssrMode &&
    opts.ssr !== false &&
    !calledDuringSSR &&
    !opts.skipCache &&
    !opts.skip
  ) {
    // result may already be in the cache from previous SSR iterations
    if (!state.data && !state.error) {
      const p = queryReq()
      client.ssrPromises.push(p)
    }
    setCalledDuringSSR(true)
  }

  const { client: clientFromOpts, ...allOptsToStringify } = allOpts
  const stringifiedAllOpts = JSON.stringify(allOptsToStringify)
  React.useEffect(() => {
    if (allOpts.skip) {
      return
    }

    queryReq()
  }, [query, stringifiedAllOpts]) // eslint-disable-line react-hooks/exhaustive-deps

  React.useEffect(() => {
    if (state.error && allOpts.throwErrors) {
      throw state.error
    }