Skip to content

Commit

Permalink
fix(gatsby-cli): Update docs links in error-map (#30493)
Browse files Browse the repository at this point in the history
  • Loading branch information
@LekoArts
LekoArts authored Apr 6, 2021
1 parent c473abf commit a777367
Showing 1 changed file with 23 additions and 21 deletions.
44 changes: 23 additions & 21 deletions packages/gatsby-cli/src/structured-errors/error-map.ts
View file
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,7 @@ const errors = {
`),
type: Type.GRAPHQL,
level: Level.ERROR,
docsUrl: `https://www.gatsbyjs.org/docs/graphql/`,
docsUrl: `https://www.gatsbyjs.com/docs/graphql/`,
category: ErrorCategory.USER,
},
"85911": {
Expand Down Expand Up @@ -204,14 +204,14 @@ const errors = {
If you're not using a page query but a useStaticQuery / StaticQuery you see this error because they currently don't support variables. To learn more about the limitations of useStaticQuery / StaticQuery, please visit these docs:
https://www.gatsbyjs.org/docs/use-static-query/
https://www.gatsbyjs.org/docs/static-query/`)
https://www.gatsbyjs.com/docs/how-to/querying-data/use-static-query/
https://www.gatsbyjs.com/docs/how-to/querying-data/static-query/`)

const generalMessage = stripIndents(`Suggestion 2:
You might have a typo in the variable name "${context.variableName}" or you didn't provide the variable via context to this page query. Have a look at the docs to learn how to add data to context:
https://www.gatsbyjs.org/docs/page-query/#how-to-add-query-variables-to-a-page-query`)
https://www.gatsbyjs.com/docs/how-to/querying-data/page-query#how-to-add-query-variables-to-a-page-query`)

return stripIndent(`
There was an error in your GraphQL query:\n\n${
Expand Down Expand Up @@ -242,14 +242,14 @@ const errors = {
It is recommended to explicitly type your GraphQL schema if you want to use optional fields. This way you don't have to add the mentioned
"dummy content". Visit our docs to learn how you can define the schema for "${context.type}":
https://www.gatsbyjs.org/docs/schema-customization/#creating-type-definitions`,
https://www.gatsbyjs.com/docs/reference/graphql-data-layer/schema-customization#creating-type-definitions`,
type: Type.GRAPHQL,
level: Level.ERROR,
category: ErrorCategory.USER,
},
"85923": {
text: (context): string =>
`There was an error in your GraphQL query:\n\n${context.sourceMessage}\n\nIf you don't expect "${context.field}" to exist on the type "${context.type}" it is most likely a typo.\nHowever, if you expect "${context.field}" to exist there are a couple of solutions to common problems:\n\n- If you added a new data source and/or changed something inside gatsby-node.js/gatsby-config.js, please try a restart of your development server\n- The field might be accessible in another subfield, please try your query in GraphiQL and use the GraphiQL explorer to see which fields you can query and what shape they have\n- You want to optionally use your field "${context.field}" and right now it is not used anywhere. Therefore Gatsby can't infer the type and add it to the GraphQL schema. A quick fix is to add at least one entry with that field ("dummy content")\n\nIt is recommended to explicitly type your GraphQL schema if you want to use optional fields. This way you don't have to add the mentioned "dummy content". Visit our docs to learn how you can define the schema for "${context.type}":\nhttps://www.gatsbyjs.org/docs/schema-customization/#creating-type-definitions`,
`There was an error in your GraphQL query:\n\n${context.sourceMessage}\n\nIf you don't expect "${context.field}" to exist on the type "${context.type}" it is most likely a typo.\nHowever, if you expect "${context.field}" to exist there are a couple of solutions to common problems:\n\n- If you added a new data source and/or changed something inside gatsby-node.js/gatsby-config.js, please try a restart of your development server\n- The field might be accessible in another subfield, please try your query in GraphiQL and use the GraphiQL explorer to see which fields you can query and what shape they have\n- You want to optionally use your field "${context.field}" and right now it is not used anywhere. Therefore Gatsby can't infer the type and add it to the GraphQL schema. A quick fix is to add at least one entry with that field ("dummy content")\n\nIt is recommended to explicitly type your GraphQL schema if you want to use optional fields. This way you don't have to add the mentioned "dummy content". Visit our docs to learn how you can define the schema for "${context.type}":\nhttps://www.gatsbyjs.com/docs/reference/graphql-data-layer/schema-customization#creating-type-definitions`,
type: Type.GRAPHQL,
level: Level.ERROR,
category: ErrorCategory.USER,
Expand All @@ -273,7 +273,7 @@ const errors = {
context.sourceMessage
}\n\nThe field "${
context.field
}" was explicitly defined as non-nullable via the schema customization API (by yourself or a plugin/theme). This means that this field is not optional and you have to define a value. If this is not your desired behavior and you defined the schema yourself, go to "createTypes" in gatsby-node.js. If you're using a plugin/theme, you can learn more here on how to fix field types:\nhttps://www.gatsbyjs.org/docs/schema-customization/#fixing-field-types${optionalGraphQLInfo(
}" was explicitly defined as non-nullable via the schema customization API (by yourself or a plugin/theme). This means that this field is not optional and you have to define a value. If this is not your desired behavior and you defined the schema yourself, go to "createTypes" in gatsby-node.js. If you're using a plugin/theme, you can learn more here on how to fix field types:\nhttps://www.gatsbyjs.com/docs/reference/graphql-data-layer/schema-customization#fixing-field-types${optionalGraphQLInfo(
context
)}`,
type: Type.GRAPHQL,
Expand Down Expand Up @@ -368,7 +368,7 @@ const errors = {
context.pageObject,
null,
4
)}\n\nSee the documentation for the "createPage" action — https://www.gatsbyjs.org/docs/actions/#createPage`,
)}\n\nSee the documentation for the "createPage" action — https://www.gatsbyjs.com/docs/reference/config-files/actions#createPage`,
level: Level.ERROR,
category: ErrorCategory.USER,
},
Expand All @@ -380,13 +380,13 @@ const errors = {
context.pageObject,
null,
4
)}\n\nSee the documentation for the "createPage" action — https://www.gatsbyjs.org/docs/actions/#createPage`,
)}\n\nSee the documentation for the "createPage" action — https://www.gatsbyjs.com/docs/reference/config-files/actions#createPage`,
level: Level.ERROR,
category: ErrorCategory.USER,
},
"11324": {
text: (context): string =>
`${context.message}\n\nSee the documentation for the "createPage" action — https://www.gatsbyjs.org/docs/actions/#createPage`,
`${context.message}\n\nSee the documentation for the "createPage" action — https://www.gatsbyjs.com/docs/reference/config-files/actions#createPage`,
level: Level.ERROR,
},
"11325": {
Expand All @@ -399,7 +399,7 @@ const errors = {
context.pageObject,
null,
4
)}\n\nSee the documentation for the "createPage" action — https://www.gatsbyjs.org/docs/actions/#createPage`,
)}\n\nSee the documentation for the "createPage" action — https://www.gatsbyjs.com/docs/reference/config-files/actions#createPage`,
level: Level.ERROR,
category: ErrorCategory.USER,
},
Expand All @@ -415,7 +415,7 @@ const errors = {
context.pageObject,
null,
4
)}\n\nSee the documentation for the "createPage" action — https://www.gatsbyjs.org/docs/actions/#createPage`,
)}\n\nSee the documentation for the "createPage" action — https://www.gatsbyjs.com/docs/reference/config-files/actions#createPage`,
level: Level.ERROR,
category: ErrorCategory.USER,
},
Expand All @@ -438,7 +438,7 @@ const errors = {
stripIndent(`
Your plugins must export known APIs from their gatsby-${context.exportType}.js.
See https://www.gatsbyjs.org/docs/${context.exportType}-apis/ for the list of Gatsby ${context.exportType} APIs.
See https://www.gatsbyjs.com/docs/reference/config-files/gatsby-${context.exportType}/ for the list of Gatsby ${context.exportType} APIs.
`),
]
.concat([``].concat(context.errors))
Expand Down Expand Up @@ -466,7 +466,9 @@ const errors = {
context.api
} lifecycle.\nLearn more about ${
context.api
} here: https://www.gatsbyjs.org/docs/node-apis/#${context.api}`,
} here: https://www.gatsbyjs.com/docs/reference/config-files/gatsby-node/#${
context.api
}`,
type: Type.PLUGIN,
level: Level.ERROR,
category: ErrorCategory.USER,
Expand Down Expand Up @@ -503,48 +505,48 @@ const errors = {
.filter(Boolean)
.join(`\n\n`),
level: Level.ERROR,
docsUrl: `https://www.gatsbyjs.org/docs/actions/#createNode`,
docsUrl: `https://www.gatsbyjs.com/docs/reference/config-files/actions#createNode`,
},
// local SSL certificate errors
"11521": {
text: (): string =>
`for custom ssl --https, --cert-file, and --key-file must be used together`,
level: Level.ERROR,
docsUrl: `https://www.gatsbyjs.org/docs/local-https/#custom-key-and-certificate-files`,
docsUrl: `https://www.gatsbyjs.com/docs/local-https#custom-key-and-certificate-files`,
category: ErrorCategory.USER,
},
"11522": {
text: (): string => `Failed to generate dev SSL certificate`,
level: Level.ERROR,
docsUrl: `https://www.gatsbyjs.org/docs/local-https/#setup`,
docsUrl: `https://www.gatsbyjs.com/docs/local-https#setup`,
},
// cli new command errors
"11610": {
text: (context): string =>
`It looks like you gave wrong argument orders . Try running instead "gatsby new ${context.starter} ${context.rootPath}"`,
level: Level.ERROR,
docsUrl: `https://www.gatsbyjs.org/docs/gatsby-cli/#new`,
docsUrl: `https://www.gatsbyjs.com/docs/reference/gatsby-cli#new`,
category: ErrorCategory.USER,
},
"11611": {
text: (context): string =>
`It looks like you passed a URL to your project name. Try running instead "gatsby new new-gatsby-project ${context.rootPath}"`,
level: Level.ERROR,
docsUrl: `https://www.gatsbyjs.org/docs/gatsby-cli/#new`,
docsUrl: `https://www.gatsbyjs.com/docs/reference/gatsby-cli#new`,
category: ErrorCategory.USER,
},
"11612": {
text: (context): string =>
`Could not create a project in "${context.path}" because it's not a valid path`,
level: Level.ERROR,
docsUrl: `https://www.gatsbyjs.org/docs/gatsby-cli/#new`,
docsUrl: `https://www.gatsbyjs.com/docs/reference/gatsby-cli#new`,
category: ErrorCategory.USER,
},
"11613": {
text: (context): string =>
`Directory ${context.rootPath} is already an npm project`,
level: Level.ERROR,
docsUrl: `https://www.gatsbyjs.org/docs/gatsby-cli/#new`,
docsUrl: `https://www.gatsbyjs.com/docs/reference/gatsby-cli#new`,
},
"11614": {
text: ({
Expand Down

0 comments on commit a777367

Please sign in to comment.