Improve error messages of `createPage` API

While experimenting with gatsby by making a simple portfolio site, I made a mistake of not supplying component property to the object passed to createPage function 🙈 This is what I made my code looked like:

const path = require('path')

exports.createPages = ({ boundActionCreators, graphql }) => {
  const { createPage } = boundActionCreators
  const blogPostTemplate = path.resolve('src/templates/blogPost.js')

  return graphql(`
    {
      allMarkdownRemark {
        edges {
          node {
            html
            frontmatter {
              title
              date
              path
              excerpt
            }
          }
        }
      }
    }
  `).then(result => {
      if (result.errors) {
        return Promise.reject(result.errors)
      }

      const { edges: posts } = result.data.allMarkdownRemark
      posts.forEach(({ node: post }) => {
        const { path } = post.frontmatter
        createPage({
          path,
          template: blogPostTemplate  // should be `component: blogPostTemplate`
        })
      })
  })
}

At that time, I didn’t realize the error and was struggling to understand what was going on. The error message I got during the build process looked like:

TypeError: Path must be a string. Received undefined

The above error message is useful but it does not clearly highlight what I was missing.

To maintainers:

What do you think about throwing an error message which reads along the lines of:

Missing required property `component`: Looks like you haven't passed a `component` property to `createPage` function.

We could point the user to the line number of the createPage function invocation.

Note: The above request is not a priority and an enhancement. I’ll let you guys decide if it is worth working on it.

[GregBorrelly]

@calcsam Status update: working on the issue, I got stuck migrating an app at work so that took a while.

[calcsam]

@GregBorrelly it’s yours – i’ll add you to the core team (check your email in the morning) and assign it to you!