Skip to content

Instantly share code, notes, and snippets.

Last active May 31, 2017 01:09
Show Gist options
  • Star 8 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save helfer/3bbd1a727e30bbad9d2873803855fb91 to your computer and use it in GitHub Desktop.
Save helfer/3bbd1a727e30bbad9d2873803855fb91 to your computer and use it in GitHub Desktop.
Migrating from Apollo Client 0.x to 1.0

Migrating from Apollo Client 0.x to 1.0

Here are the main breaking changes between the 0.x and 1.0 versions of Apollo Client.


The structure of fetchMoreResult has been changed. Previously fetchMoreResult used to contain data and loading fields, now fetchMoreResult is what used to be. This means your updateQueries function has to change as follows:

updateQuery: (prev, { fetchMoreResult }) => {
  return Object.assign({}, prev, {
    // feed: [...prev.feed,], // this is what it used to be
    feed: [...prev.feed, ...fetchMoreResult.feed], // this is what it has to be now.  

forceFetch and noFetch are replaced with fetchPolicy

The forceFetch and noFetch query options are no longer available. Instead, they have been replaced with a unified API called fetchPolicy. fetchPolicy accepts the following settings:

  • { fetchPolicy: 'cache-first' }: This is the default fetch policy that Apollo Client uses when no fetch policy is specified. First it will try to fulfill the query from the cache. Only if the cache lookup fails will a query be sent to the server.
  • { fetchPolicy: 'cache-only' }: With this option, Apollo Client will try to fulfill the query from the cache only. If not all data is available in the cache, an error will be thrown. This is equivalent to the former noFetch.
  • { fetchPolicy: 'network-only' }: With this option, Apollo Client will bypass the cache and directly send the query to the server. This is equivalent to the former forceFetch.
  • { fetchPolicy: 'cache-and-network' }: With this option, Apollo Client will query the server, but return data from the cache while the server request is pending, and later update the result when the server response has come back.


The returnPartialData query option has been removed in Apollo 1.0 because it could be hard to predict what data would be available if a query was run in this mode.

To replace the function of running one query with returnPartialData, it is recommended to run two separate queries:

  1. A large query that asks for all the data you want to display in this view once it's loaded.
  2. A small query that fetches only a subset of the larger query that you know is already cached. This query's data can then be displayed while the larger query is loading.

Here's an example:

const FullSomethingComponent => (props) => {
  if ( {
    return <PreviewSomethingComponent {...props} />

const fullQuery = gql`{
  channel(name: "x") {
    messages {

const previewQuery = gql`{
  channel(name: "x") {

const PreviewSomethingComponent => (props) => {
  if ( {
    // Whoops, we don't have that data, even though it should be in the cache. Just show a loading component
    return (<Loading />);
  // just render the channel name and topic, show loading spinner for messages, or something like that.
  return (<div> ... stuff here </div>);


const SomethingComponentWithData = graphql(fullQuery)(FullSomethingComponent);

const PreviewSomethingComponentWithData = graphql(previewQuery)(PreviewSomethingComponent);


This global option allowed applying a transform to Apollo Client before it returned query and mutation results. Because it was rarely used and complicated the logic inside Apollo Client, it has been removed. The recommended way to transform data is to apply the transform outside of Apollo Client. In react-apollo this can be done inside the props option.


Query deduplication is a global option on Apollo Client ensures that if there are multiple identical queries, Apollo Client will only send one to the server. It does this by checking a new query against queries already in flight before sending it.

queryDeduplication is set to true by default. It can be turned off by passing {queryDeduplication: false} to the Apollo Client constructor.


The boolean notifyOnNetworkStatusChange query option will trigger a new observable result every time the network status changes. Network status indicates if any request is currently in flight for this query, and provides more information about what type of request it is (initial loading, refetch, setVariables, forceFetch). In previous versions, Apollo Client would not trigger a new result on the observable if loading status changed. For more information, refer to the react-apollo documentation.

reduxRootKey and reduxRootSelector

The global reduxRootKey option was deprecated and has now been removed. In its place reduxRootSelector should be used. If you are not providing your own Redux store to Apollo, you do not need to set this option. reduxRootSelector is optional. If provided, it must be a function which returns the Apollo part of the store like so:

const client = new ApolloClient({
  reduxRootSelector: (store) => store['myCustomStoreKey'],
Copy link

helfer commented Apr 25, 2017

Added an example.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment