operationName is hard to grasp about graphql.github.io HOT 7 CLOSED

The problem is that after reading this section there is no example or other hint on the shape in which the operation's name should be specified or where to look up the spec. It would be nice to be pointed to somewhere in this section.

Good point, @martinheidegger. Would you like to submit a PR that adds a (probably small) example?

from graphql.github.io.

Operation name is a "cosmetic" name for this particular query, much like a function name in JavaScript. So:

{ me { username }}

Is like an anonymous function:

(function () {
  console.log('hello');
})()

Here's a query with an operation name:

query MeQuery {
  me { username }
}

That's like a named function:

function printGreeting() {
  console.log('hello');
}

printGreeting();

Basically it's a string you can use to refer to that function in your code, developer tools, logs, stack traces etc.

One of the most useful uses for it is in your server-side logging you can use that name to identify which queries take a long time, instead of having to look at the entire query string.

from graphql.github.io.

I guess a bug in GraphiQL?

Sounds like it could be. If you can still repro on the latest release (0.9.1), please report it over on the GraphiQL issues page.

from graphql.github.io.

I agree with this - that section introduces a lot of new concepts at the same time and should probably do that incrementally.

from graphql.github.io.

@wincent Sorry, but I havn't figured out how it is supposed to work yet.

from graphql.github.io.

@stubailo a funny thing I ran into just now that's confusing m noob brain:

when I don't use "query" as in "query { ... " and instead use just "{ ... " GraphiQL returns an error saying it "Unknown operation named "null""

If I use "query { ..." it works just fine, but if I then remove "query" and re-evaluate it works, too, but not after I refresh the GraphiQL page (then it requires 'query' qualifier again or it produces the aforementioned error.

I guess a bug in GraphiQL?

from graphql.github.io.

By the way, I wrote a post about this recently: https://dev-blog.apollodata.com/the-anatomy-of-a-graphql-query-6dffa9e9e747

If someone has time, please send some PRs to GraphQL.org with content lifted from that post!

from graphql.github.io.