GraphQL

Table of contents

• About
• Getting started

About [↑]

GraphQL is a data language for realizing APIs, which are able to query and manipulate data, developed by Facebook / Meta.

Getting started [↑]

Before we can continue, we have to install the following modules:

• express-graphql
• graphql

The following example shows, how simple it is to setup a GraphQL instance, which is quite the same, as doing it with Express:

import createServer, {
  HttpPathValidator,
  HttpRequestHandler,
} from "@egomobile/http-server";
import schema from "./graphql";
import { graphqlHTTP } from "express-graphql";

async function main() {
  const app = createServer();

  // add GraphQL middleware
  // with '/graphql' endpoint
  app.all(
    (request) => request.url!.startsWith("/graphql"),
    [
      graphqlHTTP({
        // [1] https://graphql.org/learn/schema/
        // [2] https://graphql.org/learn/queries/
        schema,
        graphiql: true, // use UI
      }) as any,
    ],
    async () => {
      /** this will never be called, but we need this there */
    }
  );

  // access UI via
  // http://localhost:8080/graphql
  await app.listen(8080);
}

main().catch(console.error);