You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: site/learn/Learn-Queries.md
+3-4Lines changed: 3 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -126,8 +126,7 @@ You can see how the above query would be pretty repetitive if the fields were re
126
126
127
127
##Operation name
128
128
129
-
Up until now, we have been using a shorthand syntax where we omit both the`query` keyword and the query name, but in production apps it's useful to use these to make our code less ambiguous.
130
-
You'll need these optional parts to a GraphQL operation if you want to execute something other than a query or pass dynamic variables.
129
+
Up until now, we have been using a shorthand syntax where we omit both the`query` keyword and the query name, but in production apps it's useful to use these to make our code less ambiguous.
131
130
132
131
Here’s an example that includes the keyword`query` as_operation type_ and`HeroNameAndFriends` as_operation name_ :
133
132
@@ -143,9 +142,9 @@ query HeroNameAndFriends {
143
142
}
144
143
```
145
144
146
-
The_operation type_ is either_query_,_mutation_, or_subscription_ and describes what type of operation you're intending to do.
145
+
The_operation type_ is either_query_,_mutation_, or_subscription_ and describes what type of operation you're intending to do. The operation type is required unless you're using the query shorthand syntax, in which case you can't supply a name or variable definitions for your operation.
147
146
148
-
The_operation name_ is a meaningful and explicit name for your operation. Itcan beveryuseful for debugging and server-side logging reasons.
147
+
The_operation name_ is a meaningful and explicit name for your operation. Itis only required in multi-operation documents, but its use is encouraged because it isveryhelpful for debugging and server-side logging.
149
148
When something goes wrong either in your network logs or your GraphQL server, it is easier to identify a query in your codebase by name instead of trying to decipher the contents.
150
149
Think of this just like a function name in your favorite programming language.
151
150
For example, in JavaScript we can easily work only with anonymous functions, but when we give a function a name, it's easier to track it down, debug our code,