Apollo Server

Spec-compliant and production ready JavaScript GraphQL server that lets you...

GraphQLExpress
apollographql/apollo-serverwww.apollographql.com/docs/apollo-server/apollo-server-express

README

@apollo/server


This @apollo/serverpackage is new with Apollo Server 4. Previous major versions of Apollo Server used a set of package names starting with apollo-server, such as apollo-server, apollo-server-express, apollo-server-core, etc.


A TypeScript/JavaScript GraphQL server


Apollo Server is an open-source , spec-compliant GraphQL serverthat's compatible with any GraphQL client, including Apollo Client . It's the best way to build a production-ready, self-documenting GraphQL API that can use data from any source.

You can use Apollo Server as:

A stand-alone GraphQL server
The GraphQL server for a subgraph in a federated supergraph
The gateway for a federated supergraph

Apollo Server provides a simple API for integrating with any Node.js web framework or serverless environment. The @apollo/serverpackage itself ships with a minimally-configurable, standalone web server which handles CORS and body parsing out of the box. Integrations with other environments are community-maintained.

Apollo Server provides:

Straightforward setup, so your client developers can start fetching data quickly
Incremental adoption, enabling you to add features as they're needed
Universal compatibilitywith any data source, any build tool, and any GraphQL client
Production readiness, enabling you to confidently run your graph in production

Documentation


Full documentation for Apollo Server is available on our documentation site . This README shows the basics of getting a server running (both standalone and with Express), but most features are only documented on our docs site.

Getting started: standalone server


You can also check out the getting started guide in the Apollo Server docs for more details, including examples in both TypeScript and JavaScript.


Apollo Server's standalone server lets you get a GraphQL server up and running quickly without needing to set up an HTTP server yourself. It allows all the same configuration of GraphQL logic as the Express integration, but does not provide the ability to make fine-grained tweaks to the HTTP-specific behavior of your server.

First, install Apollo Server and the JavaScript implementation of the core GraphQL algorithms:

  1. ``` null
  2. npm install @apollo/server graphql

  4. ```

Then, write the following to server.mjs. (By using the .mjsextension, Node lets you use the awaitkeyword at the top level.)

  1. ``` js
  2. import { ApolloServer } from '@apollo/server';
  3. import { startStandaloneServer } from '@apollo/server/standalone';

  5. // The GraphQL schema
  6. const typeDefs = `#graphql
  7.   type Query {
  8.     hello: String
  9.   }
  10. `;

  12. // A map of functions which return data for the schema.
  13. const resolvers = {
  14.   Query: {
  15.     hello: () => 'world',
  16.   },
  17. };

  19. const server = new ApolloServer({
  20.   typeDefs,
  21.   resolvers,
  22. });

  24. const { url } = await startStandaloneServer(server);
  25. console.log(`�� Server ready at ${url}`);
  26. ```

Now run your server with:

  1. ``` null
  2. node server.mjs

  4. ```

Open the URL it prints in a web browser. It will show Apollo Sandbox , a web-based tool for running GraphQL operations. Try running the operationquery { hello }!

Getting started: Express middleware


Apollo Server's built-in Express middleware lets you run your GraphQL server as part of an app built with Express , the most popular web framework for Node.

First, install Apollo Server, the JavaScript implementation of the core GraphQL algorithms, Express, and two common Express middleware packages:

  1. ``` null
  2. npm install @apollo/server graphql express cors body-parser

  4. ```

Then, write the following to server.mjs. (By using the .mjsextension, Node lets you use the awaitkeyword at the top level.)

  1. ``` js
  2. import { ApolloServer } from '@apollo/server';
  3. import { expressMiddleware } from '@apollo/server/express4';
  4. import { ApolloServerPluginDrainHttpServer } from '@apollo/server/plugin/drainHttpServer'
  5. import express from 'express';
  6. import http from 'http';
  7. import cors from 'cors';
  8. import bodyParser from 'body-parser';

  10. // The GraphQL schema
  11. const typeDefs = `#graphql
  12.   type Query {
  13.     hello: String
  14.   }
  15. `;

  17. // A map of functions which return data for the schema.
  18. const resolvers = {
  19.   Query: {
  20.     hello: () => 'world',
  21.   },
  22. };

  24. const app = express();
  25. const httpServer = http.createServer(app);

  27. // Set up Apollo Server
  28. const server = new ApolloServer({
  29.   typeDefs,
  30.   resolvers,
  31.   plugins: [ApolloServerPluginDrainHttpServer({ httpServer })],
  32. });
  33. await server.start();

  35. app.use(
  36.   cors(),
  37.   bodyParser.json(),
  38.   expressMiddleware(server),
  39. );

  41. await new Promise((resolve) => httpServer.listen({ port: 4000 }, resolve));
  42. console.log(`�� Server ready at http://localhost:4000`);
  43. ```

Now run your server with:

  1. ``` null
  2. node server.mjs

  4. ```

Open the URL it prints in a web browser. It will show Apollo Sandbox , a web-based tool for running GraphQL operations. Try running the operationquery { hello }!