Cel @relay (wzór: true)

Question

Nowe wyrażenie @relay(pattern: true) zostało wprowadzone w change log dla relay.js0.5.

Ale nie mogę dowiedzieć się z opisu ani sprawdzić, co dokładnie robi i kiedy powinienem go użyć podczas pisania fatQueries.

Przykład może być bardzo pomocny.

Answer 1

Rozważmy zapytanie GraphQL tak:

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

Podczas definiowania fat query dla mutacji Relay, aby podać nazwę pola bez określenia jego podpól mówi Relay że dowolny podpola z pole może się zmienić w wyniku tej mutacji.

Niestety pominąć argumenty połączeń, takich jak find, first i last na polu friends spowoduje błąd sprawdzania poprawności na połączenie-argumentów zależne pól edges i 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`. 

można użyć @relay(pattern: true) Dyrektywa wskazująca, że ​​chcesz użyć kwerendy grubej do wzorzec dopasowania przeciwko śledzone kwerendy, zamiast używać go jako pełnowartościowe kwerendy.

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

Aby uzyskać więcej informacji na temat mutacji patrz: https://facebook.github.io/relay/docs/guides-mutations.html#content