Scopo di @relay (modello: true)

Question

La nuova espressione @relay(pattern: true) è stata introdotta in change log per relay.js0.5.

Ma non è possibile capire dalla descrizione né testare esattamente cosa fa e quando dovrei usarlo quando si scrive fatQueries.

Alcuni esempi sarebbero molto utili.

Answer 1

consideri una query GraphQL come il seguente:

viewer { 
    friends(first: 10) { 
    totalCount 
    edges { node { name } } 
    pageInfo { hasNextPage } 
    } 
} 

Quando si definisce un fat query per una mutazione del relè, per includere il nome di un campo senza specificare uno qualsiasi dei suoi sottocampi dice Relay che qualsiasi sottocampo di quel campo potrebbe cambiare come risultato di quella mutazione.

Purtroppo, ad omettere gli argomenti di connessione come ad esempio find, first, e last sul campo friends causerà un errore di convalida sui campi di collegamento-argomento-dipendente edges e pageInfo:

getFatQuery() { 
    return Relay.QL` 
    fragment on AddFriendMutationPayload { 
     viewer { 
     friends { edges, pageInfo } # Will throw the validation error below 
     } 
    } 
    `; 
} 

// Uncaught Error: GraphQL validation/transform error ``You supplied the `pageInfo` 
// field on a connection named `friends`, but you did not supply an argument necessary 
// to do so. Use either the `find`, `first`, or `last` argument.`` in file 
// `/path/to/MyMutation.js`. 

è possibile utilizzare il Direttiva @relay(pattern: true) per indicare che si desidera utilizzare la query grossa a corrispondenza di modello rispetto alla query rilevata, anziché utilizzarla come query completa.

getFatQuery() { 
    return Relay.QL` 
    fragment on AddFriendMutationPayload @relay(pattern: true) { 
     viewer { 
     friends { edges, pageInfo } # Valid! 
     } 
    } 
    `; 
} 

Per ulteriori informazioni sulle mutazioni vedere: https://facebook.github.io/relay/docs/guides-mutations.html#content