v3.12.0-alpha.0

Minor Changes

• #12042 1c0ecbf Thanks @jerelmiller! - Introduces data masking into Apollo Client. Data masking allows components to access only the data they asked for through GraphQL fragments. This prevents coupling between components that might otherwise implicitly rely on fields not requested by the component. Data masking also provides the benefit that masked fields only rerender components that ask for the field.

  To enable data masking in Apollo Client, set the dataMasking option to true.

  new ApolloClient({
    dataMasking: true,
    // ... other options
  });

  You can selectively disable data masking using the @unmask directive. Apply this to any named fragment to receive all fields requested by the fragment.

  query {
    user {
      id
      ...UserFields @unmask
    }
  }

  To help with migration, use the @unmask migrate mode which will add warnings when accessing fields that would otherwise be masked.

  query {
    user {
      id
      ...UserFields @unmask(mode: "migrate")
    }
  }