Repolode
graphql

graphql/graphql-js

Node.js와 브라우저에서 타입이 지정된 스키마를 만들고 쿼리를 실행할 수 있는 GraphQL의 JavaScript 레퍼런스 구현입니다.

스타
20,340
포크
2,089
열린 이슈
102
마지막 커밋
16시간 전

어떤 프로젝트인가요?

GraphQL.js는 API용 쿼리 언어인 GraphQL을 JavaScript로 구현한 레퍼런스 구현입니다. Facebook에서 처음 만든 GraphQL을 사용해 코드와 매핑되는 타입 스키마를 정의하고, 해당 스키마에 대한 쿼리를 처리할 수 있습니다. 쿼리는 실행 전에 구문과 의미가 올바른지 검사하며, 유효하지 않은 쿼리는 구조화된 오류를 반환합니다.

이 라이브러리는 npm에 `graphql`이라는 이름으로 배포되며, Node.js 서버와 브라우저 모두에서 작동합니다. CommonJS와 ES module 빌드를 모두 제공하므로 webpack, rollup 같은 번들러에서 사용하는 부분만 포함할 수 있습니다. 브라우저에서 사용하는 IDE인 GraphiQL도 이 라이브러리를 기반으로 만들어졌습니다.

이 패키지는 MIT 라이선스가 적용되며 graphql 조직에서 관리합니다. 주요 릴리스별 지원 정책도 공개되어 있습니다.

핵심 기능

  • 01JavaScript 객체와 resolver 함수로 타입이 지정된 GraphQL 스키마를 구성합니다.
  • 02실행 전에 쿼리의 구문과 의미를 검증하고 명확한 오류를 반환합니다.
  • 03`graphql` 함수로 쿼리를 실행하며, resolver는 값이나 Promise를 반환할 수 있습니다.
  • 04Node.js와 브라우저에서 작동하며 CommonJS와 ES module 빌드를 제공합니다.

활용 사례

  • Node.js에서 GraphQL API 서버를 구축합니다.
  • 기존 JavaScript 데이터 소스 위에 GraphQL 계층을 추가합니다.
  • GraphiQL 같은 IDE를 만드는 등 브라우저에서 GraphQL 도구를 사용합니다.
  • 사용하는 기능만 포함하도록 tree-shaking된 클라이언트 또는 서버 번들을 구성합니다.

빠른 시작

  1. 1

    npm에서 GraphQL.js를 설치합니다

    npm install --save graphql
  2. 2

    스키마를 만들고 graphql({ schema, source })로 쿼리를 실행합니다

토픽

자주 묻는 질문

graphql-js은(는) 무엇인가요?
Node.js와 브라우저에서 타입이 지정된 스키마를 만들고 쿼리를 실행할 수 있는 GraphQL의 JavaScript 레퍼런스 구현입니다. GraphQL.js는 API용 쿼리 언어인 GraphQL을 JavaScript로 구현한 레퍼런스 구현입니다. Facebook에서 처음 만든 GraphQL을 사용해 코드와 매핑되는 타입 스키마를 정의하고, 해당 스키마에 대한 쿼리를 처리할 수 있습니다. 쿼리는 실행 전에 구문과 의미가 올바른지 검사하며, 유효하지 않은 쿼리는 구조화된 오류를 반환합니다.
graphql-js은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
graphql-js은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
graphql-js은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. graphql-js의 마지막 커밋은 2026년 10월 20일입니다.
graphql-js은(는) 어디에 사용할 수 있나요?
Node.js에서 GraphQL API 서버를 구축합니다. 기존 JavaScript 데이터 소스 위에 GraphQL 계층을 추가합니다. GraphiQL 같은 IDE를 만드는 등 브라우저에서 GraphQL 도구를 사용합니다. 사용하는 기능만 포함하도록 tree-shaking된 클라이언트 또는 서버 번들을 구성합니다.
graphql-js는 어떻게 설치하나요?
npm에서 GraphQL.js를 설치합니다: npm install --save graphql 스키마를 만들고 graphql({ schema, source })로 쿼리를 실행합니다
graphql-js은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/graphql/graphql-js

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트