https://zenn.dev/yun8boo/articles/a8a9088db88d98

こんにちは、yunbooです。

今回はThe Guildという組織が開発しているGraphQLエコシステムのGraphQL Scalarsについての記事です。

余談なんですが、The Guildは今回紹介するGraphQL Scalars以外にも様々なエコシステムを提供しており、その代表格としてはGraphQL Code Generatorがあると思います。 他にも、たくさん便利なものを提供しているので、もろもろ見てみると役に立つ情報が得られたり、面白いと思います。

さて、本題ですがGraphQL Scalarsについて説明する前の前提知識として、GraphQLのScalar型について軽く説明します。

Scalar型とは

GraphQLにはスキーマを定義する際に型が存在しますが、Scalar型とは

• プリミティブな値を表すもの
• フィールドが最終的に変換される、それ以上に分割出来ない型

GraphQLがデフォルトで用意しているのは、

• Int: 符号付き 32 ビット整数
• Float: 浮動小数点値
• String: UTF-8 文字シーケンス
• Boolean: true or false
• ID: オブジェクトの一意な識別子

の５つです。 さらに、よりスキーマの表現力を広げるために、Custom Scalarというのもあります。

Custom Scalar

先ほどの５つでほとんどのユースケースに対応はできますが、Custom Scalar型を使いより強力な型チェックや検証ができるようになります。