کتابخانه‌ی استاندارد · وب و سرویس‌ها

گراف‌کیوال graphql

سرور GraphQL: طرح‌واره، حل‌کننده‌ها، اجرای پرسمان و رسیدگی به HTTP.

واردسازی گراف‌کیوال

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

GraphQL زبانی برای پرسیدن از API است: کارخواه دقیقاً فیلدهایی را که لازم دارد می‌خواهد و سرور همان را برمی‌گرداند. این بسته پیاده‌سازی کامل سمت سرور مطابق مشخصات است. طرح‌واره را با متن SDL و تجزیه طرح‌واره بنویسید یا با تابع‌های افزودن ... بسازید، برای فیلدها حل‌کننده ثبت کنید و پرسمان را با اجرای منبع اجرا کنید.

حل‌کننده تابعی است که شماره‌ی یک شکاف را می‌گیرد؛ آرگومان‌ها و شیء والد را با آرگومان رشته و فیلد والد و مانند آن می‌خواند و پاسخ را با حل ... یا شکست می‌دهد. فیلدی که حل‌کننده ندارد مقدار هم‌نامش را از شیء والد می‌گیرد. برای سرور وب، رسیدگی ساده به وب را در یک گرداننده‌ی اچ تی تی پی صدا بزنید.

برای صدا زدن API گراف‌کیوال دیگران، کمک‌تابع‌های کارخواه ساخت بدنه درخواست و تجزیه پاسخ بدنه‌ی JSON را می‌سازند و پاسخ را می‌خوانند؛ خود درخواست را با اچ تی تی پی بفرستید. اگر هر دو سو دست خودتان است و نیازی نیست کارخواه فیلدهایش را خودش انتخاب کند، یک مسیر JSON ساده یا فراخوان دور کار کمتری می‌خواهد.

چند نکته که معمولاً غافلگیر می‌کند:

  • اشتراک (subscription) یک بار اجرا می‌شود و مثل پرسمان یک نتیجه برمی‌گرداند. جریان رویداد و انتقال وب‌سوکت در کار نیست؛ به‌روزرسانی‌ها را خودتان با وب‌سوکت بفرستید.
  • فیلدی که شکست بخورد پوچ می‌شود و بقیه‌ی پاسخ باز هم می‌رسد؛ پس حتی وقتی data هست، نتیجه موفق را بررسی کنید.
  • حل‌کننده‌ها فیلد به فیلد اجرا می‌شوند. فهرستی از ۱۰۰ نوشته که حل‌کننده‌ی author هر کدام از پایگاه داده می‌پرسد، ۱۰۰ پرسمان می‌سازد؛ همان‌طور که راهنمای اول نشان می‌دهد، آنچه فهرست لازم دارد را یک بار بار کنید.

گونه‌های مرتبط و حل‌کننده‌ی فیلد

بیشتر طرح‌واره‌ها گونه‌ها را به هم پیوند می‌دهند: نوشته نویسنده‌ای دارد و نویسنده نوشته‌هایی. به فیلد ریشه یک حل‌کننده بدهید که فهرست را برمی‌گرداند، و به فیلد پیونددهنده روی گونه‌ی فرزند حل‌کننده‌ی خودش را. درون آن، فیلد والد شیئی را که در حال حل شدن است می‌خواند، این‌جا همان نوشته، تا حل‌کننده بتواند نویسنده را با authorId پیدا کند. فیلدهای بی‌حل‌کننده، مثل title و name، از روی نامشان از شیء برداشته می‌شوند.

graphql-guide-blog.salam
واردسازی گراف‌کیوال
واردسازی کدگذاری.مقدار

ناپایا نویسندگان := مقدار.آرایه جدید()
ناپایا نوشته‌ها := مقدار.آرایه جدید()

تابع شخص(شناسه: صحیح۶۴، نام: رشته): مقدار.مقدار:
    ناپایا ش := مقدار.شیء جدید()
    مقدار.تنظیم کلید(ش، "id"، مقدار.مقدار صحیح(شناسه))
    مقدار.تنظیم کلید(ش، "name"، مقدار.مقدار رشته(نام))
    برگشت ش
پایان

تابع نوشته(شناسه: صحیح۶۴، عنوان: رشته، نویسنده: صحیح۶۴): مقدار.مقدار:
    ناپایا ن := مقدار.شیء جدید()
    مقدار.تنظیم کلید(ن، "id"، مقدار.مقدار صحیح(شناسه))
    مقدار.تنظیم کلید(ن، "title"، مقدار.مقدار رشته(عنوان))
    مقدار.تنظیم کلید(ن، "authorId"، مقدار.مقدار صحیح(نویسنده))
    برگشت ن
پایان

تابع همه نوشته‌ها(جا: صحیح۶۴):
    گراف‌کیوال.حل(جا، نوشته‌ها)
پایان

تابع نویسنده نوشته(جا: صحیح۶۴):
    خواسته := مقدار.به صحیح(گراف‌کیوال.فیلد والد(جا، "authorId"))
    تکرار مقدار.طول آرایه(نویسندگان) در ش:
        ن := مقدار.عضو آرایه(نویسندگان، ش)
        اگر مقدار.به صحیح(مقدار.مقدار کلید(ن، "id")) == خواسته:
            گراف‌کیوال.حل(جا، ن)
            برگشت
        پایان
    پایان
    گراف‌کیوال.حل تهی(جا)
پایان

تابع ریشه:
    مقدار.افزودن به آرایه(نویسندگان، شخص(۱، "سارا"))
    مقدار.افزودن به آرایه(نویسندگان، شخص(۲، "امید"))
    مقدار.افزودن به آرایه(نوشته‌ها، نوشته(۱۰، "سلام GraphQL"، ۱))
    مقدار.افزودن به آرایه(نوشته‌ها، نوشته(۱۱، "سلام و SQL"، ۲))
    مقدار.افزودن به آرایه(نوشته‌ها، نوشته(۱۲، "حل‌کننده‌ها به زبان ساده"، ۱))
    ناپایا خ := گراف‌کیوال.خطای جدید(گراف‌کیوال.دسته خطای نحوی، "")
    ناپایا طرح := گراف‌کیوال.تجزیه طرح‌واره(`
type Author { id: Int! name: String! }
type Post { id: Int! title: String! author: Author }
type Query { posts: [Post!]! }`، خ)
    _ := گراف‌کیوال.تعیین حل‌کننده(طرح، "Query"، "posts"، همه نوشته‌ها)
    _ := گراف‌کیوال.تعیین حل‌کننده(طرح، "Post"، "author"، نویسنده نوشته)
    ناپایا ن۱ := گراف‌کیوال.اجرای ساده(طرح، `{ posts { title author { name } } }`)
    سرچاپ گراف‌کیوال.نتیجه به جیسون قطعی(ن۱)
    گراف‌کیوال.آزادسازی نتیجه(ن۱)
    ناپایا ن۲ := گراف‌کیوال.اجرای ساده(طرح، `{ posts { id } }`)
    سرچاپ گراف‌کیوال.نتیجه به جیسون قطعی(ن۲)
    گراف‌کیوال.آزادسازی نتیجه(ن۲)
    گراف‌کیوال.آزادسازی طرح‌واره(طرح)
پایان
خروجی{"data": {"posts": [{"author": {"name": "سارا"}, "title": "سلام GraphQL"}, {"author": {"name": "امید"}, "title": "سلام و SQL"}, {"author": {"name": "سارا"}, "title": "حل‌کننده‌ها به زبان ساده"}]}} {"data": {"posts": [{"id": 10}, {"id": 11}, {"id": 12}]}}

پرسمان دوم اصلی‌ترین وعده‌ی GraphQL را نشان می‌دهد: فقط شناسه‌ها را می‌خواهد، پس حل‌کننده‌ی author اصلاً اجرا نمی‌شود. حل‌کننده‌ی پرهزینه، مثل جست‌وجو در پایگاه داده، فقط وقتی هزینه دارد که کارخواهی فیلدش را بخواهد. وقتی نوشته‌های زیادی نویسنده‌های مشترک دارند، نویسنده‌ها را یک بار در یک جدول جست‌وجو، مثلاً یک نگاشت با کلید شناسه، بار کنید، نه این‌که برای هر نوشته جداگانه جست‌وجو یا پرسمان کنید.

جهش با گونه‌های ورودی

تغییرها از راه گونه‌ی Mutation انجام می‌شوند. یک گونه‌ی input آرگومان‌ها را گروه می‌کند و کارخواه مقدارها را به شکل متغیر می‌فرستد تا متن پرسمان ثابت بماند. حل‌کننده شیء ورودی را با آرگومان می‌گیرد و فیلدهایش را با کدگذاری.مقدار می‌خواند.

graphql-guide-mutation.salam
واردسازی گراف‌کیوال
واردسازی کدگذاری.مقدار

ناپایا کارها := مقدار.آرایه جدید()

تابع فهرست(جا: صحیح۶۴):
    گراف‌کیوال.حل(جا، کارها)
پایان

تابع افزودن کار(جا: صحیح۶۴):
    داده := گراف‌کیوال.آرگومان(جا، "input")
    عنوان := مقدار.به رشته(مقدار.مقدار کلید(داده، "title"))
    اگر عنوان == "":
        گراف‌کیوال.شکست(جا، "عنوان نباید خالی باشد")
        برگشت
    پایان
    ناپایا ک := مقدار.شیء جدید()
    مقدار.تنظیم کلید(ک، "id"، مقدار.مقدار صحیح(مقدار.طول آرایه(کارها) + ۱))
    مقدار.تنظیم کلید(ک، "title"، مقدار.مقدار رشته(عنوان))
    ناپایا انجام := نادرست
    اگر مقدار.شیء دارد(داده، "done"):
        انجام = مقدار.به منطقی(مقدار.مقدار کلید(داده، "done"))
    پایان
    مقدار.تنظیم کلید(ک، "done"، مقدار.مقدار منطقی(انجام))
    مقدار.افزودن به آرایه(کارها، ک)
    گراف‌کیوال.حل(جا، ک)
پایان

تابع ریشه:
    ناپایا خ := گراف‌کیوال.خطای جدید(گراف‌کیوال.دسته خطای نحوی، "")
    ناپایا طرح := گراف‌کیوال.تجزیه طرح‌واره(`
type Todo { id: Int! title: String! done: Boolean! }
input TodoInput { title: String! done: Boolean = false }
type Query { todos: [Todo!]! }
type Mutation { addTodo(input: TodoInput!): Todo }`، خ)
    _ := گراف‌کیوال.تعیین حل‌کننده(طرح، "Query"، "todos"، فهرست)
    _ := گراف‌کیوال.تعیین حل‌کننده(طرح، "Mutation"، "addTodo"، افزودن کار)

    افزودن := `mutation Add($t: TodoInput!) { addTodo(input: $t) { id title done } }`
    هر عنوان در ["نوشتن گزارش"، ""، "فرستادن صورتحساب‌ها"]:
        ناپایا فیلدها := مقدار.شیء جدید()
        مقدار.تنظیم کلید(فیلدها، "title"، مقدار.مقدار رشته(عنوان))
        ناپایا متغیرها := مقدار.شیء جدید()
        مقدار.تنظیم کلید(متغیرها، "t"، فیلدها)
        ناپایا ن := گراف‌کیوال.اجرای منبع(طرح، افزودن، "Add"، متغیرها، مقدار.مقدار تهی()، مقدار.مقدار تهی())
        اگر گراف‌کیوال.نتیجه موفق(ن):
            سرچاپ گراف‌کیوال.نتیجه به جیسون قطعی(ن)
        وگرنه:
            سرچاپ "خطا:"، گراف‌کیوال.پیام خطای نتیجه(ن)
        پایان
        گراف‌کیوال.آزادسازی نتیجه(ن)
    پایان
    ناپایا همه := گراف‌کیوال.اجرای ساده(طرح، `{ todos { id title } }`)
    سرچاپ گراف‌کیوال.نتیجه به جیسون قطعی(همه)
    گراف‌کیوال.آزادسازی نتیجه(همه)
    ناپایا بد := گراف‌کیوال.اجرای ساده(طرح، `mutation { addTodo(input: { done: true }) { id } }`)
    سرچاپ گراف‌کیوال.پیام خطای نتیجه(بد)
    گراف‌کیوال.آزادسازی نتیجه(بد)
    گراف‌کیوال.آزادسازی طرح‌واره(طرح)
پایان
خروجی{"data": {"addTodo": {"done": false, "id": 1, "title": "نوشتن گزارش"}}} خطا: عنوان نباید خالی باشد (line 1, column 32) at addTodo {"data": {"addTodo": {"done": false, "id": 2, "title": "فرستادن صورتحساب‌ها"}}} {"data": {"todos": [{"id": 1, "title": "نوشتن گزارش"}, {"id": 2, "title": "فرستادن صورتحساب‌ها"}]}} argument "input" is invalid: field "title" of required type is missing (line 1, column 0)

این‌جا دو گونه خطا دیده می‌شود. وقتی حل‌کننده شکست را صدا می‌زند، درخواست اجرا شده اما آن فیلد شکست خورده و پیام، مسیر و جای فیلد را دارد. وقتی ورودی با طرح‌واره جور نیست، مثل پرسمان آخر که title اجباری را ندارد، درخواست پیش از اجرای هر حل‌کننده‌ای رد می‌شود. در هر دو حالت نتیجه موفق نادرست است و پیام خطای نتیجه نخستین پیام را می‌دهد.

زمینه‌ی هر درخواست و مجوز دسترسی

این‌که چه کسی می‌پرسد آرگومان پرسمان نیست؛ از درخواست HTTP، یک کوکی یا یک نشانه می‌آید. آن را به شکل مقدار زمینه به اجرای منبع بدهید و در هر حل‌کننده‌ای با زمینه بخوانید. حل‌کننده‌ای که اجازه نمی‌دهد شکست را صدا می‌زند و بقیه‌ی فیلدهای همان پرسمان باز هم داده‌شان را می‌گیرند.

graphql-guide-context.salam
واردسازی گراف‌کیوال
واردسازی کدگذاری.مقدار

تابع کاربر جاری(جا: صحیح۶۴): رشته:
    زمینه := گراف‌کیوال.زمینه(جا)
    اگر مقدار.شیء است(زمینه) و مقدار.شیء دارد(زمینه، "user"):
        برگشت مقدار.به رشته(مقدار.مقدار کلید(زمینه، "user"))
    پایان
    برگشت ""
پایان

تابع من(جا: صحیح۶۴):
    نام := کاربر جاری(جا)
    اگر نام == "":
        گراف‌کیوال.حل تهی(جا)
        برگشت
    پایان
    گراف‌کیوال.حل رشته(جا، نام)
پایان

تابع حقوق(جا: صحیح۶۴):
    اگر کاربر جاری(جا) != "admin":
        گراف‌کیوال.شکست(جا، "فقط مدیر می‌تواند فهرست حقوق را بخواند")
        برگشت
    پایان
    گراف‌کیوال.حل عددی(جا، ۱۸۲۰۰۰)
پایان

تابع پرسش(طرح: گراف‌کیوال.طرح‌واره، کاربر: رشته):
    ناپایا زمینه := مقدار.شیء جدید()
    اگر کاربر != "":
        مقدار.تنظیم کلید(زمینه، "user"، مقدار.مقدار رشته(کاربر))
    پایان
    ناپایا ن := گراف‌کیوال.اجرای منبع(طرح، `{ me payroll }`، ""، مقدار.مقدار تهی()، مقدار.مقدار تهی()، زمینه)
    سرچاپ "[" + کاربر + "]"، گراف‌کیوال.نتیجه به جیسون قطعی(ن)
    گراف‌کیوال.آزادسازی نتیجه(ن)
پایان

تابع ریشه:
    ناپایا خ := گراف‌کیوال.خطای جدید(گراف‌کیوال.دسته خطای نحوی، "")
    ناپایا طرح := گراف‌کیوال.تجزیه طرح‌واره(`type Query { me: String payroll: Int }`، خ)
    _ := گراف‌کیوال.تعیین حل‌کننده(طرح، "Query"، "me"، من)
    _ := گراف‌کیوال.تعیین حل‌کننده(طرح، "Query"، "payroll"، حقوق)
    پرسش(طرح، "")
    پرسش(طرح، "سارا")
    پرسش(طرح، "admin")
    گراف‌کیوال.آزادسازی طرح‌واره(طرح)
پایان
خروجی[] {"data": {"me": null, "payroll": null}, "errors": [{"locations": [{"column": 6, "line": 1}], "message": "فقط مدیر می‌تواند فهرست حقوق را بخواند", "path": ["payroll"]}]} [سارا] {"data": {"me": "سارا", "payroll": null}, "errors": [{"locations": [{"column": 6, "line": 1}], "message": "فقط مدیر می‌تواند فهرست حقوق را بخواند", "path": ["payroll"]}]} [admin] {"data": {"me": "admin", "payroll": 182000}}

دقت کنید که فیلد شکست‌خورده به‌جای از کار انداختن کل پاسخ، null می‌شود و در errors مدخلی با مسیرش می‌آید. برای همین فیلدهایی که ممکن است رد شوند باید در طرح‌واره تهی‌پذیر باشند: payroll: Int، نه payroll: Int!. فیلد ناتهی‌ای که شکست بخورد والدش را هم null می‌کند.

نقطه‌ی پایانی GraphQL روی HTTP

رسیدگی به وب یک درخواست HTTP را به پاسخ GraphQL تبدیل می‌کند: POST با بدنه‌ی JSON و GET با پرسمان در نشانی را می‌پذیرد، اجرایش می‌کند و وضعیت، نوع محتوا و بدنه‌ی پاسخ را برمی‌گرداند. آخرین آرگومانش زمینه است، پس گرداننده‌ی زیر یک نشانه‌ی Bearer را می‌خواند و نام کاربر را به حل‌کننده‌ها می‌دهد. رسیدگی ساده به وب همین کار را بدون مقدار ریشه و زمینه انجام می‌دهد.

graphql-guide-server.salam
واردسازی گراف‌کیوال
واردسازی کدگذاری.مقدار
واردسازی شبکه.اچ تی تی پی
واردسازی شبکه.مسیریاب
واردسازی رشته

ناپایا طرح := گراف‌کیوال.طرح‌واره جدید()

تابع من(جا: صحیح۶۴):
    زمینه := گراف‌کیوال.زمینه(جا)
    اگر مقدار.شیء دارد(زمینه، "user"):
        گراف‌کیوال.حل رشته(جا، مقدار.به رشته(مقدار.مقدار کلید(زمینه، "user")))
        برگشت
    پایان
    گراف‌کیوال.حل تهی(جا)
پایان

تابع پژواک(جا: صحیح۶۴):
    گراف‌کیوال.حل رشته(جا، گراف‌کیوال.آرگومان رشته(جا، "text"))
پایان

تابع نقطه پایانی(ز: صحیح۶۴):
    ناپایا زمینه درخواست := مقدار.شیء جدید()
    مجوز := اچ تی تی پی.سرصفحه(ز، "Authorization")
    اگر رشته.شروع با(مجوز، "Bearer "):
        مقدار.تنظیم کلید(زمینه درخواست، "user"، مقدار.مقدار رشته(رشته.حذف پیشوند(مجوز، "Bearer ")))
    پایان
    پاسخ := گراف‌کیوال.رسیدگی به وب(طرح، اچ تی تی پی.روش(ز)، اچ تی تی پی.سرصفحه(ز، "Content-Type")، اچ تی تی پی.بدنه(ز)، اچ تی تی پی.پرسمان خام(ز)، مقدار.مقدار تهی()، زمینه درخواست)
    اچ تی تی پی.تنظیم وضعیت(ز، پاسخ.وضعیت)
    اچ تی تی پی.تنظیم سرصفحه(ز، "Content-Type"، پاسخ.نوع محتوا)
    اچ تی تی پی.متن(ز، پاسخ.بدنه)
پایان

تابع ریشه:
    ناپایا خ := گراف‌کیوال.خطای جدید(گراف‌کیوال.دسته خطای نحوی، "")
    گراف‌کیوال.تجزیه در طرح‌واره(طرح، "type Query { me: String echo(text: String!): String! }"، خ)
    _ := گراف‌کیوال.تعیین حل‌کننده(طرح، "Query"، "me"، من)
    _ := گراف‌کیوال.تعیین حل‌کننده(طرح، "Query"، "echo"، پژواک)
    ناپایا م := مسیریاب.مسیریاب جدید()
    مسیریاب.ارسال(م، "/graphql"، نقطه پایانی)
    مسیریاب.دریافت(م، "/graphql"، نقطه پایانی)
    ناپایا س := اچ تی تی پی.سرور جدید(۸۰۹۰)
    اچ تی تی پی.استفاده(س، م)
    سرچاپ "GraphQL روی http://127.0.0.1:8090/graphql"
    اچ تی تی پی.اجرا(س)
پایان

برنامه را اجرا کنید و از پایانه‌ی دیگری پرسمان بفرستید:

curl -X POST http://127.0.0.1:8090/graphql -H 'Content-Type: application/json' \
  -d '{"query":"{ me echo(text: \"salam\") }"}'
curl -X POST http://127.0.0.1:8090/graphql -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sara' -d '{"query":"{ me }"}'
curl 'http://127.0.0.1:8090/graphql?query=%7B%20me%20%7D'
{"data": {"me": null, "echo": "salam"}}
{"data": {"me": "sara"}}
{"data": {"me": null}}

یک سرویس واقعی پیش از اعتماد به نام درون نشانه، آن را بررسی می‌کند، مثلاً با jwt. GET فقط پرسمان اجرا می‌کند و جهش‌ها باید با POST بیایند، تا یک پیوند یا یک برچسب تصویر نتواند داده را تغییر دهد.

گونه‌ها

نتیجه اجرا ExecutionResult

ساختار نتیجه اجرا
نتیجه‌ی اجرا.
نامانگلیسیگونهتوضیح
دادهdataمقدار.مقدارداده.
دارای دادهhasDataمنطقی = نادرستداده دارد؛ اگر درخواست اصلاً اجرا نشد، نه.
خطاهاerrorsفهرست خطاخطاها.
افزونه‌هاextensionsمقدار.مقدارافزونه‌ها.
دارای افزونهhasExtensionsمنطقی = نادرستافزونه دارد.
graphql-Execute.salam
واردسازی گراف‌کیوال
واردسازی کدگذاری.مقدار

تابع کتاب(شناسه: رشته، عنوان: رشته، سال: صحیح۶۴): مقدار.مقدار:
    ناپایا ک := مقدار.شیء جدید()
    مقدار.تنظیم کلید(ک، "id"، مقدار.مقدار رشته(شناسه))
    مقدار.تنظیم کلید(ک، "title"، مقدار.مقدار رشته(عنوان))
    مقدار.تنظیم کلید(ک، "year"، مقدار.مقدار صحیح(سال))
    برگشت ک
پایان

تابع سلام(ش: صحیح۶۴):
    گراف‌کیوال.حل رشته(ش، "سلام " + گراف‌کیوال.آرگومان رشته(ش، "name"))
پایان

تابع کتاب‌ها(ش: صحیح۶۴):
    ناپایا آ := مقدار.آرایه جدید()
    مقدار.افزودن به آرایه(آ، کتاب("1"، "بوف کور"، ۱۹۳۶))
    مقدار.افزودن به آرایه(آ، کتاب("2"، "سووشون"، ۱۹۶۹))
    گراف‌کیوال.حل(ش، آ)
پایان

تابع یک کتاب(ش: صحیح۶۴):
    اگر گراف‌کیوال.آرگومان عددی(ش، "id") == ۲ و وارونه مقدار.تهی است(گراف‌کیوال.آرگومان(ش، "id")):
        گراف‌کیوال.حل(ش، کتاب("2"، "سووشون"، ۱۹۶۹))
    وگرنه:
        گراف‌کیوال.حل تهی(ش)
    پایان
پایان

تابع سن(ش: صحیح۶۴):
    اگر وارونه مقدار.شیء است(گراف‌کیوال.والد(ش)):
        گراف‌کیوال.حل تهی(ش)
        برگشت
    پایان
    سال := مقدار.به صحیح(گراف‌کیوال.فیلد والد(ش، "year"))
    گراف‌کیوال.حل عددی(ش، ۲۰۲۶ - سال)
پایان

تابع امتیاز(ش: صحیح۶۴):
    گراف‌کیوال.حل اعشاری(ش، گراف‌کیوال.آرگومان اعشاری(ش، "base") * ۲.۰)
پایان

تابع موجود(ش: صحیح۶۴):
    گراف‌کیوال.حل بولی(ش، گراف‌کیوال.آرگومان بولی(ش، "only") یا گراف‌کیوال.آرگومان دارد(ش، "x"))
پایان

تابع خراب(ش: صحیح۶۴):
    گراف‌کیوال.شکست(ش، "سرویس در دسترس نیست")
پایان

تابع ریشه:
    ناپایا خطا := گراف‌کیوال.خطای جدید(گراف‌کیوال.دسته خطای نحوی، "")
    ناپایا ط := گراف‌کیوال.تجزیه طرح‌واره(`
type Query {
  hello(name: String = "دنیا"): String!
  books: [Book!]!
  book(id: Int!): Book
  score(base: Float!): Float!
  inStock(only: Boolean!): Boolean!
  broken: String
}
type Book {
  id: ID!
  title: String!
  year: Int!
  age: Int!
}`، خطا)
    _ := گراف‌کیوال.تعیین حل‌کننده(ط، "Query"، "hello"، سلام)
    _ := گراف‌کیوال.تعیین حل‌کننده(ط، "Query"، "books"، کتاب‌ها)
    _ := گراف‌کیوال.تعیین حل‌کننده(ط، "Query"، "book"، یک کتاب)
    _ := گراف‌کیوال.تعیین حل‌کننده(ط، "Query"، "score"، امتیاز)
    _ := گراف‌کیوال.تعیین حل‌کننده(ط، "Query"، "inStock"، موجود)
    _ := گراف‌کیوال.تعیین حل‌کننده(ط، "Query"، "broken"، خراب)
    _ := گراف‌کیوال.تعیین حل‌کننده(ط، "Book"، "age"، سن)
    سرچاپ گراف‌کیوال.حل‌کننده دارد(ط، "Book"، "age")، گراف‌کیوال.حل‌کننده دارد(ط، "Book"، "title")

    ناپایا ن := گراف‌کیوال.اجرای ساده(ط، `{ hello books { title year age } }`)
    سرچاپ گراف‌کیوال.نتیجه موفق(ن)
    سرچاپ گراف‌کیوال.نتیجه به جیسون قطعی(ن)
    گراف‌کیوال.آزادسازی نتیجه(ن)

    ناپایا متغیرها := مقدار.شیء جدید()
    مقدار.تنظیم کلید(متغیرها، "id"، مقدار.مقدار صحیح(۲))
    ناپایا ن۲ := گراف‌کیوال.اجرای منبع(ط، `query One($id: Int!) { book(id: $id) { title } missing: book(id: 9) { title } score(base: 1.5) inStock(only: true) hello(name: "مریم") }`، "One"، متغیرها، مقدار.مقدار تهی()، مقدار.مقدار تهی())
    سرچاپ گراف‌کیوال.نتیجه به جیسون قطعی(ن۲)
    گراف‌کیوال.آزادسازی نتیجه(ن۲)

    ناپایا ن۳ := گراف‌کیوال.اجرای ساده(ط، `{ broken hello }`)
    سرچاپ گراف‌کیوال.نتیجه موفق(ن۳)، گراف‌کیوال.پیام خطای نتیجه(ن۳)
    سرچاپ گراف‌کیوال.نتیجه به جیسون قطعی(ن۳)
    گراف‌کیوال.آزادسازی نتیجه(ن۳)

    ناپایا ن۴ := گراف‌کیوال.اجرای ساده(ط، `{ nope }`)
    سرچاپ گراف‌کیوال.پیام خطای نتیجه(ن۴)
    گراف‌کیوال.آزادسازی نتیجه(ن۴)
    گراف‌کیوال.بازنشانی شکاف‌ها()
    گراف‌کیوال.آزادسازی طرح‌واره(ط)
پایان
خروجیtrue false true {"data": {"books": [{"age": 90, "title": "بوف کور", "year": 1936}, {"age": 57, "title": "سووشون", "year": 1969}], "hello": "سلام دنیا"}} {"data": {"book": {"title": "سووشون"}, "hello": "سلام مریم", "inStock": true, "missing": null, "score": 3}} false سرویس در دسترس نیست (line 1, column 3) at broken {"data": {"broken": null, "hello": "سلام دنیا"}, "errors": [{"locations": [{"column": 3, "line": 1}], "message": "سرویس در دسترس نیست", "path": ["broken"]}]} cannot query field "nope" on type "Query" (line 1, column 3)

گروه فیلد FieldGroup

ساختار گروه فیلد
گروه گزینش‌های یک کلید پاسخ.
نامانگلیسیگونهتوضیح
کلیدkeyرشته = ""کلید.
گزینش‌هاselsوکتور<صحیح>گزینش‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

گروه‌های فیلد FieldGroups

ساختار گروه‌های فیلد
گروه‌ها.
نامانگلیسیگونهتوضیح
گروه‌هاitemsوکتور<گروه فیلد>گروه‌ها.
graphql-Internals.salam
واردسازی گراف‌کیوال
واردسازی کدگذاری.مقدار
واردسازی کدگذاری.جیسون

تابع اسم‌ها(ش: صحیح۶۴):
    گراف‌کیوال.حل رشته(ش، جیسون.کدگذاری پیش فرض(گراف‌کیوال.آرگومان‌ها(ش)))
پایان

تابع ریشه:
    ناپایا سالم := نادرست
    ج := گراف‌کیوال.توکن‌سازی(`query Q($v: [Int!]! = [1]) @x { ...F a: b(c: 2.5, d: """متن""") | & ? }`، سالم)
    ناپایا گونه‌ها := ""
    هر ت در ج.توکن‌ها:
        اگر گونه‌ها.طول() > ۰:
            گونه‌ها += " "
        پایان
        گونه‌ها += گراف‌کیوال.نام نوع توکن(ت.نوع)
    پایان
    سرچاپ سالم، گونه‌ها
    سرچاپ گراف‌کیوال.نشانه انتهای متن، گراف‌کیوال.نشانه نام، گراف‌کیوال.نشانه عدد صحیح، گراف‌کیوال.نشانه عدد اعشاری، گراف‌کیوال.نشانه رشته بلوکی، گراف‌کیوال.نشانه علامت تعجب، گراف‌کیوال.نشانه دلار
    سرچاپ گراف‌کیوال.نشانه امپرسند، گراف‌کیوال.نشانه پرانتز باز، گراف‌کیوال.نشانه پرانتز بسته، گراف‌کیوال.نشانه پخش، گراف‌کیوال.نشانه دونقطه، گراف‌کیوال.نشانه مساوی، گراف‌کیوال.نشانه ات
    سرچاپ گراف‌کیوال.نشانه کروشه باز، گراف‌کیوال.نشانه کروشه بسته، گراف‌کیوال.نشانه آکولاد بسته، گراف‌کیوال.نشانه خط عمودی، گراف‌کیوال.نشانه خطا

    ناپایا خطا := گراف‌کیوال.خطای جدید(گراف‌کیوال.دسته خطای نحوی، "")
    ناپایا ط := گراف‌کیوال.تجزیه طرح‌واره(`
type Query { names(a: Boolean, b: Float, o: In, v: Int): String! book: Book }
input In { x: Int! }
type Book { id: ID! title: String! }`، خطا)
    _ := گراف‌کیوال.تعیین حل‌کننده(ط، "Query"، "names"، اسم‌ها)

    ناپایا س := گراف‌کیوال.تجزیه(`query ($v: Int, $l: [Int!]) { names(a: true, b: 1.5, o: { x: 3 }, v: $v) book { id ...F ... on Book { title } } }
fragment F on Book { title }`، خطا)
    عملیات := س.عملیات‌ها.دریافت(۰)
    سرچاپ عملیات.نوع عملیات == گراف‌کیوال.عملیات پرسمان
    نام‌ها := گراف‌کیوال.گزینش در(س، عملیات.گزینش‌ها.دریافت(۰))
    ناپایا متغیرها := مقدار.شیء جدید()
    مقدار.تنظیم کلید(متغیرها، "v"، مقدار.مقدار صحیح(۴۲))
    هر آ در نام‌ها.آرگومان‌ها:
        م := گراف‌کیوال.مقدار در(س، آ.مقدار)
        ل := گراف‌کیوال.تبدیل لفظ به مقدار(ط، س، آ.مقدار، متغیرها)
        سرچاپ آ.نام، م.نوع == گراف‌کیوال.مقدار بولی، م.نوع == گراف‌کیوال.مقدار اعشاری، م.نوع == گراف‌کیوال.مقدار شیء، م.نوع == گراف‌کیوال.مقدار متغیر، ل.موفق، جیسون.کدگذاری پیش فرض(ل.مقدار)
    پایان

    ل۲ := عملیات.تعریف‌های متغیر.دریافت(۱).ارجاع نوع
    عنصر := گراف‌کیوال.عنصر ارجاع نوع(س، ل۲)
    سرچاپ گراف‌کیوال.چاپ ارجاع نوع(س، ل۲)، گراف‌کیوال.چاپ ارجاع نوع(س، عنصر)، گراف‌کیوال.ارجاع نوع در(س، عنصر).نوع == گراف‌کیوال.ارجاع نوع نام‌دار
    ناپایا فهرست := مقدار.آرایه جدید()
    مقدار.افزودن به آرایه(فهرست، مقدار.مقدار صحیح(۱))
    مقدار.افزودن به آرایه(فهرست، مقدار.مقدار رشته("دو"))
    ت := گراف‌کیوال.تبدیل ورودی(ط، س، ل۲، فهرست)
    سرچاپ ت.موفق، ت.پیام.طول() > ۰

    کتاب := گراف‌کیوال.گزینش در(س، عملیات.گزینش‌ها.دریافت(۱))
    سرچاپ گراف‌کیوال.گزینش در(س، کتاب.گزینش‌ها.دریافت(۱)).نوع == گراف‌کیوال.گزینش پخش قطعه، گراف‌کیوال.گزینش در(س، کتاب.گزینش‌ها.دریافت(۲)).نوع == گراف‌کیوال.گزینش قطعه درون‌خطی
    ناپایا گروه‌ها := گراف‌کیوال.گردآوری فیلدها(ط، س، کتاب.گزینش‌ها، "Book"، متغیرها)
    هر گ در گروه‌ها.گروه‌ها:
        سرچاپ گ.کلید، گ.گزینش‌ها.طول()، گراف‌کیوال.ادغام گزینش‌ها(س، گ).طول()
    پایان
    گراف‌کیوال.آزادسازی گروه‌های فیلد(گروه‌ها)

    ناپایا ن := گراف‌کیوال.اجرا(ط، س، ""، متغیرها، مقدار.مقدار تهی()، مقدار.مقدار تهی())
    ناپایا افزونه := مقدار.شیء جدید()
    مقدار.تنظیم کلید(افزونه، "ms"، مقدار.مقدار صحیح(۳))
    گراف‌کیوال.تعیین افزونه‌ها(ن، افزونه)
    سرچاپ مقدار.شیء است(گراف‌کیوال.نتیجه به مقدار(ن))
    سرچاپ گراف‌کیوال.نتیجه به جیسون با تورفتگی(ن)
    گراف‌کیوال.آزادسازی نتیجه(ن)
    گراف‌کیوال.آزادسازی سند(س)
    گراف‌کیوال.آزادسازی طرح‌واره(ط)
    گراف‌کیوال.آزادسازی خطا(خطا)
پایان
خروجیfalse Name Name ( $ Name : [ Name ! ] ! = [ Int ] ) @ Name { ... Name Name : Name ( Name : Float Name : BlockString ) | & <error> } <EOF> 0 1 2 3 5 6 7 8 9 10 11 12 13 14 15 16 18 19 20 true a true false false false true true b false true false false true 1.5 o false false true false true {"x": 3} v false false false true true 42 [Int!] Int! true false true true true id 1 0 title 2 0 true { "data": { "names": "{\"a\": true, \"b\": 1.5, \"o\": {\"x\": 3}, \"v\": 42}", "book": null }, "extensions": { "ms": 3 } }

درخواست وب GqlHttpRequest

ساختار درخواست وب
درخواست GraphQL روی HTTP.
نامانگلیسیگونهتوضیح
پرسمانqueryرشته = ""متن پرسمان.
نام عملیاتoperationNameرشته = ""نام عملیات.
متغیرهاvariablesمقدار.مقدارمتغیرها.
افزونه‌هاextensionsمقدار.مقدارافزونه‌ها.
موفقokمنطقی = درستدرست خوانده شد.
خطاerrorرشته = ""اگر نه، دلیل.
graphql-Http.salam
واردسازی گراف‌کیوال
واردسازی کدگذاری.مقدار
واردسازی شبکه.اچ تی تی پی
واردسازی شبکه.مسیریاب

ناپایا طرح := گراف‌کیوال.طرح‌واره جدید()

تابع من(ش: صحیح۶۴):
    ز := گراف‌کیوال.زمینه(ش)
    ناپایا نام := "مهمان"
    اگر مقدار.شیء دارد(ز، "user"):
        نام = مقدار.به رشته(مقدار.مقدار کلید(ز، "user"))
    پایان
    گراف‌کیوال.حل رشته(ش، نام + " (" + گراف‌کیوال.نام نوع والد(ش) + "." + گراف‌کیوال.نام فیلد(ش) + ")")
پایان

تابع جمع(ش: صحیح۶۴):
    گراف‌کیوال.حل عددی(ش، گراف‌کیوال.آرگومان عددی(ش، "a") + گراف‌کیوال.آرگومان عددی(ش، "b"))
پایان

تابع نقطه پایانی(ز: صحیح۶۴):
    پ := گراف‌کیوال.رسیدگی ساده به وب(طرح، اچ تی تی پی.روش(ز)، اچ تی تی پی.سرصفحه(ز، "Content-Type")، اچ تی تی پی.بدنه(ز)، اچ تی تی پی.پرسمان خام(ز))
    اچ تی تی پی.تنظیم وضعیت(ز، پ.وضعیت)
    اچ تی تی پی.تنظیم سرصفحه(ز، "Content-Type"، پ.نوع محتوا)
    اچ تی تی پی.متن(ز، پ.بدنه)
پایان

تابع ریشه:
    ناپایا خطا := گراف‌کیوال.خطای جدید(گراف‌کیوال.دسته خطای نحوی، "")
    گراف‌کیوال.تجزیه در طرح‌واره(طرح، "type Query { me: String! add(a: Int!, b: Int!): Int! }"، خطا)
    _ := گراف‌کیوال.تعیین حل‌کننده(طرح، "Query"، "me"، من)
    _ := گراف‌کیوال.تعیین حل‌کننده(طرح، "Query"، "add"، جمع)

    ناپایا م := مسیریاب.مسیریاب جدید()
    مسیریاب.ارسال(م، "/graphql"، نقطه پایانی)
    مسیریاب.دریافت(م، "/graphql"، نقطه پایانی)
    ناپایا س := اچ تی تی پی.سرور جدید(۱۹۶۱۳)
    اچ تی تی پی.استفاده(س، م)
    _ := اچ تی تی پی.اجرا در پس زمینه(س)

    ناپایا متغیر := مقدار.شیء جدید()
    مقدار.تنظیم کلید(متغیر، "x"، مقدار.مقدار صحیح(۴۰))
    بدنه := گراف‌کیوال.ساخت بدنه درخواست("query Sum($x: Int!) { add(a: $x, b: 2) }"، "Sum"، متغیر)
    سرچاپ بدنه
    ناپایا سر := اچ تی تی پی.سرصفحه جدید()
    سر.درج("Content-Type"، "application/json")
    پ := اچ تی تی پی.ارسال با("http://127.0.0.1:19613/graphql"، بدنه، سر)
    سرچاپ اچ تی تی پی.وضعیت(پ)، اچ تی تی پی.بدنه(پ)
    ناپایا ج := گراف‌کیوال.تجزیه پاسخ(اچ تی تی پی.بدنه(پ))
    سرچاپ گراف‌کیوال.پاسخ موفق(ج)، ج.دارای داده، مقدار.به صحیح(گراف‌کیوال.فیلد پاسخ(ج، "add"))
    گراف‌کیوال.آزادسازی پاسخ کارخواه(ج)

    پرس := گراف‌کیوال.ساخت رشته پرس‌وجو("{ me }"، ""، مقدار.مقدار تهی())
    پ۲ := اچ تی تی پی.دریافت("http://127.0.0.1:19613/graphql?" + پرس)
    سرچاپ اچ تی تی پی.بدنه(پ۲)
    پ۳ := اچ تی تی پی.ارسال با("http://127.0.0.1:19613/graphql"، گراف‌کیوال.ساخت بدنه پرس‌وجو("{ nope }")، سر)
    ناپایا ج۳ := گراف‌کیوال.تجزیه پاسخ(اچ تی تی پی.بدنه(پ۳))
    سرچاپ اچ تی تی پی.وضعیت(پ۳)، گراف‌کیوال.پاسخ موفق(ج۳)، گراف‌کیوال.پیام خطای پاسخ(ج۳)
    گراف‌کیوال.آزادسازی پاسخ کارخواه(ج۳)

    ناپایا د := گراف‌کیوال.تجزیه درخواست جیسون(`{"query":"{ me }"}`)
    ناپایا زمینه := مقدار.شیء جدید()
    مقدار.تنظیم کلید(زمینه، "user"، مقدار.مقدار رشته("مریم"))
    ناپایا ن := گراف‌کیوال.رسیدگی به درخواست(طرح، د، مقدار.مقدار تهی()، زمینه)
    سرچاپ گراف‌کیوال.نتیجه به جیسون(ن)
    گراف‌کیوال.آزادسازی نتیجه(ن)
    گراف‌کیوال.آزادسازی درخواست وب(د)
    ب := گراف‌کیوال.تجزیه درخواست وب("PUT"، "application/json"، "{}"، "")
    سرچاپ ب.موفق، ب.خطا
    پ۴ := گراف‌کیوال.رسیدگی به وب(طرح، "POST"، "application/json"، "not json"، ""، مقدار.مقدار تهی()، مقدار.مقدار تهی())
    سرچاپ پ۴.وضعیت
پایان
خروجی{"query": "query Sum($x: Int!) { add(a: $x, b: 2) }", "operationName": "Sum", "variables": {"x": 40}} 200 {"data": {"add": 42}} true true 42 {"data": {"me": "مهمان (Query.me)"}} 400 false cannot query field "nope" on type "Query" (line 1, column 3) {"data": {"me": "مریم (Query.me)"}} false only GET and POST are supported 400

پاسخ وب GqlHttpResponse

ساختار پاسخ وب
پاسخ HTTP.
نامانگلیسیگونهتوضیح
وضعیتstatusصحیح = 200کد وضعیت.
نوع محتواcontentTypeرشته = "application/json"نوع محتوا.
بدنهbodyرشته = ""بدنه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

خطای گراف‌کیوال GqlError

ساختار خطای گراف‌کیوال
یک خطا.
نامانگلیسیگونهتوضیح
دستهcategoryصحیحدسته.
پیامmessageرشته = ""پیام.
خطlineصحیح = 0خط.
ستونcolصحیح = 0ستون.
دارای مکانhasLocationمنطقی = نادرستجا دارد.
کلیدهای مسیرpathKeysوکتور<رشته>کلیدهای مسیر در پاسخ.
شاخص‌های مسیرpathIndexوکتور<صحیح>نمایه‌های مسیر؛ ۱- برای کلید.
کدcodeرشته = ""کد اختیاری در extensions.
graphql-Document.salam
واردسازی گراف‌کیوال
واردسازی کدگذاری.مقدار

تابع ریشه:
    متن := `query Books($limit: Int = 5) { books(limit: $limit, tags: ["a", "b"]) @include(if: true) { ...Info alias: title } }
fragment Info on Book { id year }`
    سرچاپ گراف‌کیوال.تجزیه موفق(متن)، گراف‌کیوال.تجزیه موفق("{ a ")، گراف‌کیوال.تحلیل واژگانی موفق("{ a }")
    ناپایا خطا := گراف‌کیوال.خطای جدید(گراف‌کیوال.دسته خطای نحوی، "")
    ناپایا س := گراف‌کیوال.تجزیه(متن، خطا)
    سرچاپ س.عملیات‌ها.طول()، س.قطعه‌ها.طول()
    چاپ گراف‌کیوال.چاپ(س)
    ع := گراف‌کیوال.یافتن عملیات(س، "Books")
    عملیات := س.عملیات‌ها.دریافت(ع)
    سرچاپ عملیات.نام، گراف‌کیوال.نام نوع عملیات(عملیات.نوع عملیات)، عملیات.کوتاه‌نویسی، عملیات.تعریف‌های متغیر.طول()، عملیات.خط
    گ := گراف‌کیوال.گزینش در(س، عملیات.گزینش‌ها.دریافت(۰))
    سرچاپ گ.نوع == گراف‌کیوال.گزینش فیلد، گ.نام، گراف‌کیوال.کلید پاسخ(گ)، گ.آرگومان‌ها.طول()، گ.دستورالعمل‌ها.طول()، گ.گزینش‌ها.طول()، گ.خط، گ.ستون
    آرگ := گ.آرگومان‌ها.دریافت(۱)
    سرچاپ آرگ.نام، گراف‌کیوال.چاپ مقدار(س، آرگ.مقدار)، گراف‌کیوال.مقدار در(س، آرگ.مقدار).نوع == گراف‌کیوال.مقدار فهرست
    تعریف := عملیات.تعریف‌های متغیر.دریافت(۰)
    سرچاپ تعریف.نام، گراف‌کیوال.چاپ ارجاع نوع(س، تعریف.ارجاع نوع)، گراف‌کیوال.نام ارجاع نوع(س، تعریف.ارجاع نوع)
    سرچاپ گراف‌کیوال.ارجاع نوع ناتهی است(س، تعریف.ارجاع نوع)، گراف‌کیوال.ارجاع نوع فهرست است(س، تعریف.ارجاع نوع)، گراف‌کیوال.ارجاع نوع در(س، تعریف.ارجاع نوع).نام
    ق := س.قطعه‌ها.دریافت(گراف‌کیوال.یافتن قطعه(س، "Info"))
    سرچاپ ق.نام، ق.شرط نوع، ق.گزینش‌ها.طول()
    سرچاپ گراف‌کیوال.چاپ مقدار رشته("سلام \"دنیا\"")
    گراف‌کیوال.آزادسازی سند(س)

    ناپایا سالم := نادرست
    ج := گراف‌کیوال.توکن‌سازی(`{ a(x: 1.5, y: "s") }`، سالم)
    سرچاپ سالم، ج.توکن‌ها.طول()
    ت := ج.توکن‌ها.دریافت(۵)
    سرچاپ گراف‌کیوال.نام نوع توکن(ت.نوع)، ت.متن، ت.مقدار اعشاری، ت.خط، ت.ستون
    سرچاپ گراف‌کیوال.توکن رشته است(گراف‌کیوال.نشانه رشته)، گراف‌کیوال.نام نوع توکن(گراف‌کیوال.نشانه آکولاد باز)

    _ := گراف‌کیوال.تجزیه("{ a(", خطا)
    سرچاپ خطا.دسته == گراف‌کیوال.دسته خطای نحوی، خطا.خط، خطا.ستون، خطا.دارای مکان
    سرچاپ گراف‌کیوال.رشته خطا(خطا)

    ناپایا ف := گراف‌کیوال.خطای جدید(گراف‌کیوال.دسته خطای اجرا، "شکست")
    گراف‌کیوال.افزودن کلید مسیر(ف، "books")
    گراف‌کیوال.افزودن نمایه مسیر(ف، ۲)
    گراف‌کیوال.افزودن کلید مسیر(ف، "title")
    سرچاپ گراف‌کیوال.طول مسیر(ف)، گراف‌کیوال.رشته مسیر(ف)
    ناپایا فهرست := گراف‌کیوال.فهرست خطا {}
    گراف‌کیوال.افزودن خطا(فهرست، ف)
    گراف‌کیوال.افزودن خطا(فهرست، گراف‌کیوال.خطا در محل(گراف‌کیوال.دسته خطای اعتبارسنجی، "بد"، ۳، ۷))
    گراف‌کیوال.افزودن خطا(فهرست، گراف‌کیوال.خطای نحوی("پرانتز باز مانده"، ۱، ۴))
    سرچاپ گراف‌کیوال.خطا دارد(فهرست)، گراف‌کیوال.تعداد خطا(فهرست)، گراف‌کیوال.خطا در(فهرست، ۱).خط
    سرچاپ مقدار.طول آرایه(گراف‌کیوال.خطاها به مقدار(فهرست))، مقدار.شیء است(گراف‌کیوال.خطا به مقدار(ف))
    گراف‌کیوال.آزادسازی خطا(خطا)
    گراف‌کیوال.آزادسازی فهرست خطا(فهرست)
    سرچاپ گراف‌کیوال.دسته خطای درخواست، گراف‌کیوال.ویرایش مشخصات

    ناپایا ط := گراف‌کیوال.تجزیه طرح‌واره("type Query { n(x: Int!): Int e: Color } enum Color { RED }"، خطا)
    سرچاپ گراف‌کیوال.اعتبارسنجی منبع(ط، "{ n(x: \"a\") }").خطاها.طول() > ۰
    ناپایا س۲ := گراف‌کیوال.تجزیه("{ n(x: 1) e }"، خطا)
    سرچاپ گراف‌کیوال.اعتبارسنجی موفق(ط، س۲)، گراف‌کیوال.اعتبارسنجی(ط، س۲).خطاها.طول()
    ب := گراف‌کیوال.تبدیل نتیجه برگ(ط، "Color"، مقدار.مقدار رشته("RED"))
    سرچاپ ب.موفق، مقدار.به رشته(ب.مقدار)
    ب۲ := گراف‌کیوال.تبدیل نتیجه برگ(ط، "Int"، مقدار.مقدار رشته("x"))
    سرچاپ ب۲.موفق، ب۲.پیام.طول() > ۰
    گراف‌کیوال.آزادسازی سند(س۲)
    گراف‌کیوال.آزادسازی طرح‌واره(ط)
پایان
خروجیtrue false true 1 1 query Books($limit: Int = 5) { books(limit: $limit, tags: ["a", "b"]) @include(if: true) { ...Info alias: title } } fragment Info on Book { id year } Books query false 1 1 true books books 2 1 2 1 32 tags ["a", "b"] true limit Int Int false false Int Info Book 2 "سلام \"دنیا\"" true 12 Float 1.5 1.5 1 8 true { true 1 5 true unterminated argument list (line 1, column 5) 3 books[2].title true 3 3 3 true 3 October2021 true true 0 true RED false true

فهرست خطا GqlErrorList

ساختار فهرست خطا
فهرست خطاها.
نامانگلیسیگونهتوضیح
خطاهاitemsوکتور<خطای گراف‌کیوال>خطاها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

نتیجه تبدیل CoerceResult

ساختار نتیجه تبدیل
نتیجه‌ی تبدیل یک مقدار.
نامانگلیسیگونهتوضیح
موفقokمنطقی = درستتبدیل شد.
پیامmessageرشته = ""پیام خطا.
مقدارvalueمقدار.مقدارمقدار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

وضعیت اجرا Ex

ساختار وضعیت اجرا
وضعیت داخلی اجرا.
نامانگلیسیگونهتوضیح
طرح‌وارهschطرح‌وارهطرح‌واره.
سندdocسندسند.
متغیرهاvarsمقدار.مقدارمتغیرها.
زمینهctxمقدار.مقدارزمینه.
خطاهاerrorsفهرست خطاخطاها.
کلیدهای مسیرpathKeysوکتور<رشته>مسیر جاری.
شاخص‌های مسیرpathIdxوکتور<صحیح>نمایه‌های مسیر.
عمقdepthصحیح = 0عمق.
بیشینه عمقmaxDepthصحیح = 512بیشترین عمق مجاز.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

توکن GqlToken

ساختار توکن
یک نشانه.
نامانگلیسیگونهتوضیح
نوعkindصحیحگونه، یکی از ثابت‌های نشانه ....
متنlexemeرشته = ""متن.
مقدار رشتهsvalرشته = ""مقدار رشته.
مقدار صحیحivalصحیح۶۴ = 0مقدار صحیح.
مقدار اعشاریfvalاعشار۶۴ = 0مقدار اعشاری.
خطlineصحیح = 0خط.
ستونcolصحیح = 0ستون.
موقعیتposصحیح = 0جای آغاز در متن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

جریان توکن GqlTokenStream

ساختار جریان توکن
فهرست نشانه‌ها.
نامانگلیسیگونهتوضیح
توکن‌هاtoksوکتور<توکن>نشانه‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

مقدار نحوی AstValue

ساختار مقدار نحوی
یک مقدار در سند.
نامانگلیسیگونهتوضیح
نوعkindصحیحگونه، یکی از ثابت‌های مقدار ....
مقدار منطقیbمنطقی = نادرستمقدار بولی.
مقدار صحیحiصحیح۶۴ = 0مقدار صحیح.
مقدار اعشاریfاعشار۶۴ = 0مقدار اعشاری.
مقدار رشتهsرشته = ""رشته، نام شمارشی یا نام متغیر.
عناصرitemsوکتور<صحیح>عنصرهای فهرست یا مقدارهای شیء.
کلیدهاkeysوکتور<رشته>کلیدهای شیء.
خطlineصحیح = 0خط.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

ارجاع نوع AstTypeRef

ساختار ارجاع نوع
یک ارجاع نوع.
نامانگلیسیگونهتوضیح
نوعkindصحیحنام‌دار یا فهرست.
نامnameرشته = ""نام نوع.
درونیinnerصحیح = -1ارجاع درونی فهرست.
غیرتهیnonNullمنطقی = نادرستبا ! ناتهی است.
graphql-Schema.salam
واردسازی گراف‌کیوال

تابع ریشه:
    ناپایا ط := گراف‌کیوال.طرح‌واره جدید()
    گراف‌کیوال.افزودن نوع اسکالر(ط، "Date"، "تاریخ به شکل YYYY-MM-DD")
    گراف‌کیوال.افزودن نوع رابط(ط، "Node"، "")
    _ := گراف‌کیوال.افزودن فیلد(ط، "Node"، "id"، "ID!")
    گراف‌کیوال.افزودن نوع شیء(ط، "Author"، "نویسنده")
    گراف‌کیوال.افزودن رابط به(ط، "Author"، "Node")
    _ := گراف‌کیوال.افزودن فیلد(ط، "Author"، "id"، "ID!")
    _ := گراف‌کیوال.افزودن فیلد(ط، "Author"، "name"، "String!")
    _ := گراف‌کیوال.افزودن فیلد(ط، "Author"، "born"، "Date")
    ناپایا ژانرها := وکتور {} برگردان وکتور<رشته>
    ژانرها.افزودن("NOVEL")
    ژانرها.افزودن("POETRY")
    گراف‌کیوال.افزودن نوع شمارشی(ط، "Genre"، ژانرها)
    ناپایا اعضا := وکتور {} برگردان وکتور<رشته>
    اعضا.افزودن("Author")
    گراف‌کیوال.افزودن نوع اجتماع(ط، "SearchResult"، اعضا)
    گراف‌کیوال.افزودن نوع ورودی(ط، "AuthorInput"، "")
    _ := گراف‌کیوال.افزودن فیلد ورودی(ط، "AuthorInput"، "name"، "String!")
    گراف‌کیوال.افزودن نوع شیء(ط، "Query"، "")
    _ := گراف‌کیوال.افزودن فیلد(ط، "Query"، "authors"، "[Author!]!")
    _ := گراف‌کیوال.افزودن فیلد(ط، "Query"، "search"، "[SearchResult!]!")
    _ := گراف‌کیوال.افزودن آرگومان فیلد(ط، "Query"، "search"، "text"، "String!")
    _ := گراف‌کیوال.افزودن آرگومان فیلد(ط، "Query"، "search"، "genre"، "Genre")
    گراف‌کیوال.افزودن نوع شیء(ط، "Mutation"، "")
    _ := گراف‌کیوال.افزودن فیلد(ط، "Mutation"، "addAuthor"، "Author!")
    _ := گراف‌کیوال.افزودن آرگومان فیلد(ط، "Mutation"، "addAuthor"، "input"، "AuthorInput!")
    گراف‌کیوال.تعیین انواع ریشه(ط، "Query"، "Mutation"، "")
    چاپ گراف‌کیوال.چاپ طرح‌واره(ط)
    سرچاپ "---"
    سرچاپ گراف‌کیوال.چاپ نوع(ط، "Genre")

    سرچاپ گراف‌کیوال.نوع دارد(ط، "Author")، گراف‌کیوال.نمایه نوع(ط، "Author") >= ۰، گراف‌کیوال.تعداد نوع(ط) > ۵
    ن := گراف‌کیوال.یافتن نوع(ط، "Author")
    سرچاپ ن.نام، ن.نوع == گراف‌کیوال.گونه شیء، ن.توضیح، گراف‌کیوال.فیلد دارد(ن، "born")
    ف := گراف‌کیوال.یافتن فیلد(گراف‌کیوال.یافتن نوع(ط، "Query")، "search")
    سرچاپ ف.نام، گراف‌کیوال.یافتن آرگومان(ف، "genre").نام، گراف‌کیوال.یافتن آرگومان(ف، "genre").دارای پیش‌فرض
    سرچاپ گراف‌کیوال.یافتن فیلد ورودی(گراف‌کیوال.یافتن نوع(ط، "AuthorInput")، "name").نام
    سرچاپ گراف‌کیوال.مقدار شمارشی دارد(گراف‌کیوال.یافتن نوع(ط، "Genre")، "POETRY")
    سرچاپ گراف‌کیوال.نوع ورودی است(ط، "AuthorInput")، گراف‌کیوال.نوع خروجی است(ط، "AuthorInput")، گراف‌کیوال.نوع برگ است(ط، "Genre")
    سرچاپ گراف‌کیوال.نوع انتزاعی است(ط، "SearchResult")، گراف‌کیوال.نوع ممکن است(ط، "Node"، "Author")، گراف‌کیوال.انواع ممکن(ط، "Node").طول()
    سرچاپ گراف‌کیوال.نام نوع ریشه(ط، گراف‌کیوال.عملیات تغییر)، گراف‌کیوال.نام نوع ریشه(ط، گراف‌کیوال.عملیات اشتراک).طول()
    سرچاپ گراف‌کیوال.یافتن تعریف دستورالعمل(ط، "deprecated").نام
    سرچاپ گراف‌کیوال.نوع در(ط، ۰).نام.طول() > ۰
    سرچاپ گراف‌کیوال.نوع درون‌نگری است("__Schema")، گراف‌کیوال.نوع درون‌نگری است("Author")
    گراف‌کیوال.افزودن انواع درون‌نگری(ط)
    سرچاپ گراف‌کیوال.نوع دارد(ط، "__Type")، گراف‌کیوال.چاپ کامل طرح‌واره(ط).طول() > گراف‌کیوال.چاپ طرح‌واره(ط).طول()
    سرچاپ گراف‌کیوال.متن ارجاع نوع(ط، "[Int!]") >= ۰

    سرچاپ گراف‌کیوال.تجزیه طرح‌واره موفق("type Query { a: Int }")، گراف‌کیوال.تجزیه طرح‌واره موفق("type {")
    ناپایا خطا := گراف‌کیوال.خطای جدید(گراف‌کیوال.دسته خطای نحوی، "")
    گراف‌کیوال.تجزیه در طرح‌واره(ط، "extend type Author { alias: String }"، خطا)
    سرچاپ گراف‌کیوال.فیلد دارد(گراف‌کیوال.یافتن نوع(ط، "Author")، "alias")، خطا.پیام.طول()
    سرچاپ گراف‌کیوال.گونه نرده‌ای، گراف‌کیوال.گونه رابط، گراف‌کیوال.گونه اجتماع، گراف‌کیوال.گونه شمارشی، گراف‌کیوال.گونه شیء ورودی
    گراف‌کیوال.آزادسازی طرح‌واره(ط)
پایان
خروجی"تاریخ به شکل YYYY-MM-DD" scalar Date interface Node { id: ID! } "نویسنده" type Author implements Node { id: ID! name: String! born: Date } enum Genre { NOVEL POETRY } union SearchResult = Author input AuthorInput { name: String! } type Query { authors: [Author!]! search(text: String!, genre: Genre): [SearchResult!]! } type Mutation { addAuthor(input: AuthorInput!): Author! } --- enum Genre { NOVEL POETRY } true true true Author true نویسنده true search genre false name true true false true true true 1 Mutation 0 deprecated true true false true true true true false true 0 0 2 3 4 5

آرگومان نحوی AstArgument

ساختار آرگومان نحوی
یک آرگومان.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام.
مقدارvalueصحیح = -1شماره‌ی مقدار.
خطlineصحیح = 0خط.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

دستورالعمل نحوی AstDirective

ساختار دستورالعمل نحوی
یک دستورالعمل، مثل @include.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام.
آرگومان‌هاargsوکتور<آرگومان نحوی>آرگومان‌ها.
خطlineصحیح = 0خط.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

گزینش نحوی AstSelection

ساختار گزینش نحوی
یک گزینش: فیلد، پخش قطعه یا قطعه‌ی درون‌خطی.
نامانگلیسیگونهتوضیح
نوعkindصحیحگونه، یکی از ثابت‌های گزینش ....
نامnameرشته = ""نام فیلد یا قطعه.
نام مستعارaliasرشته = ""نام دیگر فیلد در پاسخ.
شرط نوعtypeConditionرشته = ""نوع قطعه‌ی درون‌خطی.
دارای شرط نوعhasTypeConditionمنطقی = نادرستنوع دارد.
آرگومان‌هاargsوکتور<آرگومان نحوی>آرگومان‌ها.
دستورالعمل‌هاdirectivesوکتور<دستورالعمل نحوی>دستورالعمل‌ها.
گزینش‌هاselectionsوکتور<صحیح>زیرگزینش‌ها.
خطlineصحیح = 0خط.
ستونcolصحیح = 0ستون.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

تعریف متغیر AstVariableDef

ساختار تعریف متغیر
تعریف یک متغیر.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام بی $.
ارجاع نوعtypeRefصحیح = -1ارجاع نوع.
مقدار پیش‌فرضdefaultValueصحیح = -1شماره‌ی مقدار پیش‌فرض.
دارای پیش‌فرضhasDefaultمنطقی = نادرستپیش‌فرض دارد.
دستورالعمل‌هاdirectivesوکتور<دستورالعمل نحوی>دستورالعمل‌ها.
خطlineصحیح = 0خط.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

عملیات نحوی AstOperation

ساختار عملیات نحوی
یک عملیات.
نامانگلیسیگونهتوضیح
نوع عملیاتoptypeصحیحنوع، یکی از ثابت‌های عملیات ....
نامnameرشته = ""نام؛ برای پرسمان کوتاه خالی.
تعریف‌های متغیرvarDefsوکتور<تعریف متغیر>تعریف متغیرها.
دستورالعمل‌هاdirectivesوکتور<دستورالعمل نحوی>دستورالعمل‌ها.
گزینش‌هاselectionsوکتور<صحیح>شماره‌ی گزینش‌های ریشه.
کوتاه‌نویسیshorthandمنطقی = نادرستبه شکل کوتاه { ... } نوشته شده.
خطlineصحیح = 0خط.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

قطعه نحوی AstFragment

ساختار قطعه نحوی
یک قطعه.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام.
شرط نوعtypeConditionرشته = ""نوعی که قطعه رویش است.
دستورالعمل‌هاdirectivesوکتور<دستورالعمل نحوی>دستورالعمل‌ها.
گزینش‌هاselectionsوکتور<صحیح>گزینش‌ها.
خطlineصحیح = 0خط.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

سند Document

ساختار سند
سند تجزیه‌شده: عملیات‌ها و قطعه‌ها؛ گزینش‌ها، مقدارها و ارجاع‌های نوع با شماره در فهرست‌های سند نگه داشته می‌شوند.
نامانگلیسیگونهتوضیح
عملیات‌هاopsوکتور<عملیات نحوی>عملیات‌ها.
قطعه‌هاfragsوکتور<قطعه نحوی>قطعه‌ها.
گزینش‌هاselsوکتور<گزینش نحوی>گزینش‌ها.
مقدارهاvalsوکتور<مقدار نحوی>مقدارها.
ارجاع‌های نوعtrefsوکتور<ارجاع نوع>ارجاع‌های نوع.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

تعریف مقدار ورودی InputValueDef

ساختار تعریف مقدار ورودی
تعریف یک آرگومان یا فیلد ورودی.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام.
توضیحdescriptionرشته = ""توضیح.
ارجاع نوعtypeRefصحیح = -1ارجاع نوع.
مقدار پیش‌فرضdefaultValueصحیح = -1مقدار پیش‌فرض در سند.
دارای پیش‌فرضhasDefaultمنطقی = نادرستمقدار پیش‌فرض دارد.
منسوخis_deprecatedمنطقی = نادرستمنسوخ است.
دلیل منسوخیdeprecationReasonرشته = ""دلیل منسوخ شدن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

تعریف فیلد FieldDef

ساختار تعریف فیلد
تعریف یک فیلد.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام.
توضیحdescriptionرشته = ""توضیح.
ارجاع نوعtypeRefصحیح = -1ارجاع نوع.
آرگومان‌هاargsوکتور<تعریف مقدار ورودی>آرگومان‌ها.
منسوخis_deprecatedمنطقی = نادرستمنسوخ است.
دلیل منسوخیdeprecationReasonرشته = ""دلیل منسوخ شدن.
حل‌کنندهresolverصحیح۶۴ = 0حل‌کننده‌ی ثبت‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

تعریف مقدار شمارشی EnumValueDef

ساختار تعریف مقدار شمارشی
یک مقدار شمارشی.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام.
توضیحdescriptionرشته = ""توضیح.
منسوخis_deprecatedمنطقی = نادرستمنسوخ است.
دلیل منسوخیdeprecationReasonرشته = ""دلیل منسوخ شدن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

تعریف نوع TypeDef

ساختار تعریف نوع
تعریف یک نوع.
نامانگلیسیگونهتوضیح
نوعkindصحیحگونه، یکی از ثابت‌های گونه ....
نامnameرشته = ""نام.
توضیحdescriptionرشته = ""توضیح.
فیلدهاfieldsوکتور<تعریف فیلد>فیلدها، برای شیء و رابط.
فیلدهای‌ورودیinputFieldsوکتور<تعریف مقدار ورودی>فیلدهای نوع ورودی.
رابط‌هاinterfacesوکتور<رشته>رابط‌هایی که پیاده می‌کند.
اعضای اتحادunionMembersوکتور<رشته>اعضای اجتماع.
مقادیر شمارشیenumValuesوکتور<تعریف مقدار شمارشی>مقدارهای شمارشی.
نشانی مشخصاتspecifiedByURLرشته = ""نشانی مشخصات نوع نرده‌ای.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

تعریف دستورالعمل DirectiveDef

ساختار تعریف دستورالعمل
تعریف یک دستورالعمل.
نامانگلیسیگونهتوضیح
نامnameرشته = ""نام.
توضیحdescriptionرشته = ""توضیح.
آرگومان‌هاargsوکتور<تعریف مقدار ورودی>آرگومان‌ها.
مکان‌هاlocationsوکتور<رشته>جاهایی که به کار می‌رود.
تکرارپذیرrepeatableمنطقی = نادرستچند بار روی یک جا مجاز است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

طرح‌واره Schema

ساختار طرح‌واره
طرح‌واره: همه‌ی نوع‌ها، دستورالعمل‌ها و نوع‌های ریشه.
نامانگلیسیگونهتوضیح
سندdocسندسند داخلی که ارجاع‌های نوع در آن نگه داشته می‌شوند.
نوع‌هاtypesوکتور<تعریف نوع>نوع‌ها.
دستورالعمل‌هاdirectivesوکتور<تعریف دستورالعمل>دستورالعمل‌ها.
نوع پرسمانqueryTypeرشته = "Query"نام نوع ریشه‌ی پرسمان.
نوع جهشmutationTypeرشته = ""نام نوع ریشه‌ی تغییر.
نوع اشتراکsubscriptionTypeرشته = ""نام نوع ریشه‌ی اشتراک.
توضیحdescriptionرشته = ""توضیح طرح‌واره.
دارای تعریف طرحhasSchemaDefمنطقی = نادرستبلوک schema { ... } صریح داشت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

وضعیت اعتبارسنجی Vx

ساختار وضعیت اعتبارسنجی
وضعیت داخلی اعتبارسنجی.
نامانگلیسیگونهتوضیح
طرح‌وارهschطرح‌وارهطرح‌واره.
سندdocسندسند.
خطاهاerrorsفهرست خطاخطاها.
قطعه‌های استفاده‌شدهusedFragmentsوکتور<رشته>قطعه‌های به‌کاررفته.
متغیرهای استفاده‌شدهusedVarsوکتور<رشته>متغیرهای به‌کاررفته.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

پاسخ کارخواه ClientResponse

ساختار پاسخ کارخواه
پاسخی که کارخواه از سرور گرفته.
نامانگلیسیگونهتوضیح
دادهdataمقدار.مقدارداده.
دارای دادهhasDataمنطقی = نادرستداده دارد.
خطاهاerrorsفهرست خطاخطاها.
افزونه‌هاextensionsمقدار.مقدارافزونه‌ها.
دارای افزونهhasExtensionsمنطقی = نادرستافزونه دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

شکاف حل‌کننده ResolverSlot

ساختار شکاف حل‌کننده
وضعیت یک فراخوان حل‌کننده.
نامانگلیسیگونهتوضیح
مشغولbusyمنطقی = نادرستدر استفاده.
والدparentمقدار.مقداروالد.
آرگومان‌هاargsمقدار.مقدارآرگومان‌ها.
زمینهctxمقدار.مقدارزمینه.
نام فیلدfieldNameرشته = ""نام فیلد.
نوع والدparentTypeرشته = ""نوع والد.
نتیجهresultمقدار.مقدارنتیجه.
حل‌شدهresolvedمنطقی = نادرستنتیجه تعیین شد.
ناموفقfailedمنطقی = نادرستشکست خورد.
پیامmessageرشته = ""پیام خطا.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

جدول شکاف GqlSlotTable

ساختار جدول شکاف
جدول شکاف‌ها.
نامانگلیسیگونهتوضیح
شکاف‌هاitemsوکتور<شکاف حل‌کننده>شکاف‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

پایاها و متغیرها

دسته خطای نحوی ERR_SYNTAX

پایا دسته خطای نحوی: صحیح۳۲ = 0
دسته‌ی خطا: نحو.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

دسته خطای اعتبارسنجی ERR_VALIDATION

پایا دسته خطای اعتبارسنجی: صحیح۳۲ = 1
دسته‌ی خطا: اعتبارسنجی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

دسته خطای اجرا ERR_EXECUTION

پایا دسته خطای اجرا: صحیح۳۲ = 2
دسته‌ی خطا: اجرا، مثلاً شکست حل‌کننده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

دسته خطای درخواست ERR_REQUEST

پایا دسته خطای درخواست: صحیح۳۲ = 3
دسته‌ی خطا: درخواست HTTP نادرست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

نشانه انتهای متن TOK_EOF

پایا نشانه انتهای متن: صحیح۳۲ = 0
گونه‌ی نشانه: پایان متن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه نام TOK_NAME

پایا نشانه نام: صحیح۳۲ = 1
گونه‌ی نشانه: نام.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه عدد صحیح TOK_INT

پایا نشانه عدد صحیح: صحیح۳۲ = 2
گونه‌ی نشانه: عدد صحیح.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه عدد اعشاری TOK_FLOAT

پایا نشانه عدد اعشاری: صحیح۳۲ = 3
گونه‌ی نشانه: عدد اعشاری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه رشته TOK_STRING

پایا نشانه رشته: صحیح۳۲ = 4
گونه‌ی نشانه: رشته.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

نشانه رشته بلوکی TOK_BLOCK_STRING

پایا نشانه رشته بلوکی: صحیح۳۲ = 5
گونه‌ی نشانه: رشته‌ی بلوکی """.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه علامت تعجب TOK_BANG

پایا نشانه علامت تعجب: صحیح۳۲ = 6
گونه‌ی نشانه: !.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه دلار TOK_DOLLAR

پایا نشانه دلار: صحیح۳۲ = 7
گونه‌ی نشانه: $.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه امپرسند TOK_AMP

پایا نشانه امپرسند: صحیح۳۲ = 8
گونه‌ی نشانه: &.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه پرانتز باز TOK_LPAREN

پایا نشانه پرانتز باز: صحیح۳۲ = 9
گونه‌ی نشانه: (.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه پرانتز بسته TOK_RPAREN

پایا نشانه پرانتز بسته: صحیح۳۲ = 10
گونه‌ی نشانه: ).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه پخش TOK_SPREAD

پایا نشانه پخش: صحیح۳۲ = 11
گونه‌ی نشانه: ....

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه دونقطه TOK_COLON

پایا نشانه دونقطه: صحیح۳۲ = 12
گونه‌ی نشانه: :.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه مساوی TOK_EQUALS

پایا نشانه مساوی: صحیح۳۲ = 13
گونه‌ی نشانه: =.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه ات TOK_AT

پایا نشانه ات: صحیح۳۲ = 14
گونه‌ی نشانه: @.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه کروشه باز TOK_LBRACKET

پایا نشانه کروشه باز: صحیح۳۲ = 15
گونه‌ی نشانه: [.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه کروشه بسته TOK_RBRACKET

پایا نشانه کروشه بسته: صحیح۳۲ = 16
گونه‌ی نشانه: ].

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه آکولاد باز TOK_LBRACE

پایا نشانه آکولاد باز: صحیح۳۲ = 17
گونه‌ی نشانه: {.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

نشانه آکولاد بسته TOK_RBRACE

پایا نشانه آکولاد بسته: صحیح۳۲ = 18
گونه‌ی نشانه: }.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه خط عمودی TOK_PIPE

پایا نشانه خط عمودی: صحیح۳۲ = 19
گونه‌ی نشانه: |.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نشانه خطا TOK_ERROR

پایا نشانه خطا: صحیح۳۲ = 20
گونه‌ی نشانه: نشانه‌ی نادرست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

ویرایش مشخصات SpecEdition

پایا ویرایش مشخصات: رشته = "October2021"
ویرایش مشخصات GraphQL که پیاده شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

مقدار تهی VAL_NULL

پایا مقدار تهی: صحیح۳۲ = 0
گونه‌ی مقدار: تهی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

مقدار بولی VAL_BOOL

پایا مقدار بولی: صحیح۳۲ = 1
گونه‌ی مقدار: بولی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

مقدار صحیح VAL_INT

پایا مقدار صحیح: صحیح۳۲ = 2
گونه‌ی مقدار: صحیح.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

مقدار اعشاری VAL_FLOAT

پایا مقدار اعشاری: صحیح۳۲ = 3
گونه‌ی مقدار: اعشاری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

مقدار رشته VAL_STRING

پایا مقدار رشته: صحیح۳۲ = 4
گونه‌ی مقدار: رشته.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

مقدار شمارشی VAL_ENUM

پایا مقدار شمارشی: صحیح۳۲ = 5
گونه‌ی مقدار: شمارشی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

مقدار فهرست VAL_LIST

پایا مقدار فهرست: صحیح۳۲ = 6
گونه‌ی مقدار: فهرست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

مقدار شیء VAL_OBJECT

پایا مقدار شیء: صحیح۳۲ = 7
گونه‌ی مقدار: شیء.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

مقدار متغیر VAL_VARIABLE

پایا مقدار متغیر: صحیح۳۲ = 8
گونه‌ی مقدار: متغیر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

ارجاع نوع نام‌دار TREF_NAMED

پایا ارجاع نوع نام‌دار: صحیح۳۲ = 0
ارجاع نوع: نام‌دار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

ارجاع نوع فهرست TREF_LIST

پایا ارجاع نوع فهرست: صحیح۳۲ = 1
ارجاع نوع: فهرست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

گزینش فیلد SEL_FIELD

پایا گزینش فیلد: صحیح۳۲ = 0
گزینش: فیلد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

گزینش پخش قطعه SEL_FRAGMENT_SPREAD

پایا گزینش پخش قطعه: صحیح۳۲ = 1
گزینش: پخش قطعه، مثل ...Info.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

گزینش قطعه درون‌خطی SEL_INLINE_FRAGMENT

پایا گزینش قطعه درون‌خطی: صحیح۳۲ = 2
گزینش: قطعه‌ی درون‌خطی، مثل ... on Book.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

عملیات پرسمان OP_QUERY

پایا عملیات پرسمان: صحیح۳۲ = 0
عملیات: پرسمان.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

عملیات تغییر OP_MUTATION

پایا عملیات تغییر: صحیح۳۲ = 1
عملیات: تغییر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

عملیات اشتراک OP_SUBSCRIPTION

پایا عملیات اشتراک: صحیح۳۲ = 2
عملیات: اشتراک.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

گونه نرده‌ای TYPE_SCALAR

پایا گونه نرده‌ای: صحیح۳۲ = 0
گونه‌ی نوع: نرده‌ای، مثل Int یا String.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

گونه شیء TYPE_OBJECT

پایا گونه شیء: صحیح۳۲ = 1
گونه‌ی نوع: شیء.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

گونه رابط TYPE_INTERFACE

پایا گونه رابط: صحیح۳۲ = 2
گونه‌ی نوع: رابط.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

گونه اجتماع TYPE_UNION

پایا گونه اجتماع: صحیح۳۲ = 3
گونه‌ی نوع: اجتماع.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

گونه شمارشی TYPE_ENUM

پایا گونه شمارشی: صحیح۳۲ = 4
گونه‌ی نوع: شمارشی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

گونه شیء ورودی TYPE_INPUT_OBJECT

پایا گونه شیء ورودی: صحیح۳۲ = 5
گونه‌ی نوع: شیء ورودی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

تابع‌ها

نوع درون‌نگری است IsIntrospectionType

تابع نوع درون‌نگری است(name: رشته): منطقی
نام یکی از نوع‌های درون‌نگری، مثل __Type، است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن انواع درون‌نگری AddIntrospectionTypes

تابع افزودن انواع درون‌نگری(sch &: طرح‌واره)
نوع‌های درون‌نگری را به طرح‌واره می‌افزاید تا پرسمان‌های __schema کار کنند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

چاپ طرح‌واره PrintSchema

تابع چاپ طرح‌واره(sch: طرح‌واره): رشته
طرح‌واره را به SDL برمی‌گرداند، بدون نوع‌های داخلی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

چاپ کامل طرح‌واره PrintSchemaFull

تابع چاپ کامل طرح‌واره(sch: طرح‌واره): رشته
طرح‌واره را با نوع‌های داخلی برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

چاپ نوع PrintType

تابع چاپ نوع(sch: طرح‌واره، name: رشته): رشته
SDL یک نوع.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

اجرا Execute

تابع اجرا(sch: طرح‌واره، doc: سند، operationName: رشته، variables: مقدار.مقدار، rootValue: مقدار.مقدار، ctx: مقدار.مقدار): نتیجه اجرا
سند تجزیه‌شده را با نام عملیات، متغیرها، مقدار ریشه و زمینه اجرا می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

اجرای منبع ExecuteSource

تابع اجرای منبع(sch: طرح‌واره، source: رشته، operationName: رشته، variables: مقدار.مقدار، rootValue: مقدار.مقدار، ctx: مقدار.مقدار): نتیجه اجرا
مثل تابع بالا، از متن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

اجرای ساده Run

تابع اجرای ساده(sch: طرح‌واره، source: رشته): نتیجه اجرا
متن را بدون متغیر اجرا می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

تعیین افزونه‌ها SetExtensions

تابع تعیین افزونه‌ها(r &: نتیجه اجرا، ext: مقدار.مقدار)
افزونه‌های نتیجه را تعیین می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نتیجه به مقدار ResultToValue

تابع نتیجه به مقدار(r: نتیجه اجرا): مقدار.مقدار
نتیجه به شکل مقدار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نتیجه به جیسون ResultToJSON

تابع نتیجه به جیسون(r: نتیجه اجرا): رشته
نتیجه به شکل جیسون.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

نتیجه به جیسون با تورفتگی ResultToJSONIndent

تابع نتیجه به جیسون با تورفتگی(r: نتیجه اجرا): رشته
جیسون خوانا با تورفتگی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نتیجه به جیسون قطعی ResultToJSONStable

تابع نتیجه به جیسون قطعی(r: نتیجه اجرا): رشته
جیسون با کلیدهای مرتب؛ برای آزمون و مقایسه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

نتیجه موفق ResultOk

تابع نتیجه موفق(r: نتیجه اجرا): منطقی
بی خطا اجرا شد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

پیام خطای نتیجه ResultErrorMessage

تابع پیام خطای نتیجه(r: نتیجه اجرا): رشته
پیام نخستین خطا.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

آزادسازی نتیجه FreeResult

تابع آزادسازی نتیجه(r &: نتیجه اجرا)
نتیجه را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

گردآوری فیلدها CollectFields

تابع گردآوری فیلدها(sch: طرح‌واره، doc: سند، sels: وکتور<صحیح>، objectType: رشته، vars: مقدار.مقدار): گروه‌های فیلد
گزینش‌ها را با قطعه‌ها و دستورالعمل‌های include و skip به گروه‌های کلید پاسخ تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

ادغام گزینش‌ها MergeSelections

تابع ادغام گزینش‌ها(doc: سند، g: گروه فیلد): وکتور<صحیح>
زیرگزینش‌های یک گروه را یکی می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

آزادسازی گروه‌های فیلد FreeFieldGroups

تابع آزادسازی گروه‌های فیلد(gs &: گروه‌های فیلد)
گروه‌ها را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

تجزیه درخواست وب ParseHttpRequest

تابع تجزیه درخواست وب(method: رشته، contentType: رشته، body: رشته، queryString: رشته): درخواست وب
درخواست را از روش، نوع محتوا، بدنه و رشته‌ی پرسمان می‌خواند؛ GET و POST با جیسون یا application/graphql.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

تجزیه درخواست جیسون ParseHttpRequestJSON

تابع تجزیه درخواست جیسون(body: رشته): درخواست وب
بدنه‌ی جیسون را می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

رسیدگی به درخواست HandleRequest

تابع رسیدگی به درخواست(sch: طرح‌واره، req: درخواست وب، rootValue: مقدار.مقدار، ctx: مقدار.مقدار): نتیجه اجرا
درخواست خوانده‌شده را اجرا می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

رسیدگی به وب HandleHttp

تابع رسیدگی به وب(sch: طرح‌واره، method: رشته، contentType: رشته، body: رشته، queryString: رشته، rootValue: مقدار.مقدار، ctx: مقدار.مقدار): پاسخ وب
درخواست HTTP را از ورودی خام تا پاسخ کامل رسیدگی می‌کند، با مقدار ریشه و زمینه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

رسیدگی ساده به وب HandleHttpSimple

تابع رسیدگی ساده به وب(sch: طرح‌واره، method: رشته، contentType: رشته، body: رشته، queryString: رشته): پاسخ وب
مثل تابع بالا، بی مقدار ریشه و زمینه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

آزادسازی درخواست وب FreeHttpRequest

تابع آزادسازی درخواست وب(req &: درخواست وب)
درخواست را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

چاپ مقدار رشته PrintStringValue

تابع چاپ مقدار رشته(s: رشته): رشته
رشته را به شکل رشته‌ی GraphQL با گریز برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

چاپ ارجاع نوع PrintTypeRef

تابع چاپ ارجاع نوع(doc: سند، id: صحیح): رشته
متن یک ارجاع نوع.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

چاپ مقدار PrintValue

تابع چاپ مقدار(doc: سند، id: صحیح): رشته
متن یک مقدار سند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

چاپ Print

تابع چاپ(doc: سند): رشته
سند را به متن مرتب برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

توکن‌سازی Tokenize

تابع توکن‌سازی(source: رشته، ok &: منطقی): جریان توکن
متن را به نشانه‌ها می‌شکند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

تحلیل واژگانی موفق LexOk

تابع تحلیل واژگانی موفق(source: رشته): منطقی
متن بی خطای واژگانی است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

خطای جدید NewError

تابع خطای جدید(category: صحیح، message: رشته): خطای گراف‌کیوال
خطا با دسته و پیام.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

خطا در محل NewErrorAt

تابع خطا در محل(category: صحیح، message: رشته، line: صحیح، col: صحیح): خطای گراف‌کیوال
خطا با جای خط و ستون.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

خطای نحوی SyntaxError

تابع خطای نحوی(message: رشته، line: صحیح، col: صحیح): خطای گراف‌کیوال
خطای نحو با جا.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن کلید مسیر PathPushKey

تابع افزودن کلید مسیر(e &: خطای گراف‌کیوال، key: رشته)
کلیدی به مسیر خطا می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

افزودن نمایه مسیر PathPushIndex

تابع افزودن نمایه مسیر(e &: خطای گراف‌کیوال، idx: صحیح)
نمایه‌ای به مسیر می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

طول مسیر PathLen

تابع طول مسیر(e: خطای گراف‌کیوال): صحیح
طول مسیر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

رشته مسیر PathString

تابع رشته مسیر(e: خطای گراف‌کیوال): رشته
مسیر به شکل books[2].title.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

افزودن خطا AddError

تابع افزودن خطا(list &: فهرست خطا، e: خطای گراف‌کیوال)
خطا را به فهرست می‌افزاید؛ فهرست مالک خطا می‌شود، پس آن را جدا آزاد نکنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

خطا دارد HasErrors

تابع خطا دارد(list: فهرست خطا): منطقی
فهرست خطا دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

تعداد خطا ErrorCount

تابع تعداد خطا(list: فهرست خطا): صحیح
شمار خطاها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

خطا در ErrorAt

تابع خطا در(list: فهرست خطا، i: صحیح): خطای گراف‌کیوال
خطای شماره‌ی n.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

رشته خطا ErrorString

تابع رشته خطا(e: خطای گراف‌کیوال): رشته
متن خطا با جا و مسیر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

خطا به مقدار ErrorToValue

تابع خطا به مقدار(e: خطای گراف‌کیوال): مقدار.مقدار
خطا به شکل مقدار برای پاسخ جیسون.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

خطاها به مقدار ErrorsToValue

تابع خطاها به مقدار(list: فهرست خطا): مقدار.مقدار
فهرست خطاها به شکل آرایه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

آزادسازی خطا FreeError

تابع آزادسازی خطا(e &: خطای گراف‌کیوال)
خطا را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

آزادسازی فهرست خطا FreeErrorList

تابع آزادسازی فهرست خطا(list &: فهرست خطا)
فهرست و همه‌ی خطاهایش را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

تبدیل لفظ به مقدار LiteralToValue

تابع تبدیل لفظ به مقدار(sch: طرح‌واره، doc: سند، valueId: صحیح، vars: مقدار.مقدار): نتیجه تبدیل
مقدار سند را با جایگذاری متغیرها به مقدار کدگذاری تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

تبدیل ورودی CoerceInput

تابع تبدیل ورودی(sch: طرح‌واره، refDoc: سند، typeRef: صحیح، v: مقدار.مقدار): نتیجه تبدیل
مقدار ورودی را با نوع داده‌شده سازگار می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

تبدیل نتیجه برگ CoerceLeafResult

تابع تبدیل نتیجه برگ(sch: طرح‌واره، typeName: رشته، v: مقدار.مقدار): نتیجه تبدیل
خروجی حل‌کننده را با نوع برگ، مثل Int یا شمارشی، سازگار می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

نام نوع توکن TokenKindName

تابع نام نوع توکن(kind: صحیح): رشته
نام گونه‌ی نشانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

توکن رشته است IsStringToken

تابع توکن رشته است(kind: صحیح): منطقی
گونه رشته یا رشته‌ی بلوکی است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

گزینش در SelectionAt

تابع گزینش در(doc: سند، id: صحیح): گزینش نحوی
گزینش با شماره.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

مقدار در ValueAt

تابع مقدار در(doc: سند، id: صحیح): مقدار نحوی
مقدار با شماره.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

ارجاع نوع در TypeRefAt

تابع ارجاع نوع در(doc: سند، id: صحیح): ارجاع نوع
ارجاع نوع با شماره.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

یافتن عملیات FindOperation

تابع یافتن عملیات(doc: سند، name: رشته): صحیح
شماره‌ی عملیات با نام؛ نام خالی یعنی تنها عملیات. اگر نباشد، ۱-.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

یافتن قطعه FindFragment

تابع یافتن قطعه(doc: سند، name: رشته): صحیح
شماره‌ی قطعه با نام.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

نام نوع عملیات OperationTypeName

تابع نام نوع عملیات(optype: صحیح): رشته
نام عملیات: query، mutation یا subscription.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

کلید پاسخ ResponseKey

تابع کلید پاسخ(sel: گزینش نحوی): رشته
کلید گزینش در پاسخ: نام دیگر، یا اگر نباشد، نام فیلد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

آزادسازی سند FreeDocument

تابع آزادسازی سند(doc &: سند)
سند را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

تجزیه Parse

تابع تجزیه(source: رشته، err &: خطای گراف‌کیوال): سند
سند پرسمان را تجزیه می‌کند؛ اگر نحو نادرست باشد، خطا پر می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

تجزیه موفق ParseOk

تابع تجزیه موفق(source: رشته): منطقی
متن پرسمان درست است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

تجزیه طرح‌واره ParseSchema

تابع تجزیه طرح‌واره(source: رشته، err &: خطای گراف‌کیوال): طرح‌واره
طرح‌واره را از متن SDL می‌سازد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

تجزیه در طرح‌واره ParseSchemaInto

تابع تجزیه در طرح‌واره(sch &: طرح‌واره، source: رشته، err &: خطای گراف‌کیوال)
متن SDL، از جمله extend type، را به طرح‌واره‌ی موجود می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

تجزیه طرح‌واره موفق ParseSchemaOk

تابع تجزیه طرح‌واره موفق(source: رشته): منطقی
متن SDL درست است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

ارجاع نوع ناتهی است TypeRefIsNonNull

تابع ارجاع نوع ناتهی است(doc: سند، id: صحیح): منطقی
ارجاع ناتهی است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

ارجاع نوع فهرست است TypeRefIsList

تابع ارجاع نوع فهرست است(doc: سند، id: صحیح): منطقی
ارجاع فهرست است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

عنصر ارجاع نوع TypeRefElement

تابع عنصر ارجاع نوع(doc: سند، id: صحیح): صحیح
ارجاع عنصر فهرست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

نام ارجاع نوع TypeRefName

تابع نام ارجاع نوع(doc: سند، id: صحیح): رشته
نام نوع پایه، بی فهرست و !.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

یافتن نوع FindType

تابع یافتن نوع(s: طرح‌واره، name: رشته): تعریف نوع
تعریف نوع با این نام.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

نوع دارد HasType

تابع نوع دارد(s: طرح‌واره، name: رشته): منطقی
نوع هست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

نمایه نوع TypeIndex

تابع نمایه نوع(s: طرح‌واره، name: رشته): صحیح
شماره‌ی نوع؛ اگر نباشد، ۱-.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

تعداد نوع TypeCount

تابع تعداد نوع(s: طرح‌واره): صحیح
شمار نوع‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

نوع در TypeAt

تابع نوع در(s: طرح‌واره، i: صحیح): تعریف نوع
نوع شماره‌ی n.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

یافتن فیلد FindField

تابع یافتن فیلد(t: تعریف نوع، name: رشته): تعریف فیلد
فیلد نوع.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

فیلد دارد HasField

تابع فیلد دارد(t: تعریف نوع، name: رشته): منطقی
نوع این فیلد را دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

یافتن فیلد ورودی FindInputField

تابع یافتن فیلد ورودی(t: تعریف نوع، name: رشته): تعریف مقدار ورودی
فیلد نوع ورودی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

یافتن آرگومان FindArg

تابع یافتن آرگومان(f: تعریف فیلد، name: رشته): تعریف مقدار ورودی
آرگومان فیلد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

یافتن تعریف دستورالعمل FindDirectiveDef

تابع یافتن تعریف دستورالعمل(s: طرح‌واره، name: رشته): تعریف دستورالعمل
تعریف دستورالعمل.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

مقدار شمارشی دارد HasEnumValue

تابع مقدار شمارشی دارد(t: تعریف نوع، name: رشته): منطقی
نوع شمارشی این مقدار را دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

نوع ورودی است IsInputType

تابع نوع ورودی است(s: طرح‌واره، name: رشته): منطقی
نوع در ورودی‌ها مجاز است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

نوع خروجی است IsOutputType

تابع نوع خروجی است(s: طرح‌واره، name: رشته): منطقی
نوع در خروجی‌ها مجاز است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

نوع انتزاعی است IsAbstractType

تابع نوع انتزاعی است(s: طرح‌واره، name: رشته): منطقی
رابط یا اجتماع است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

نوع برگ است IsLeafType

تابع نوع برگ است(s: طرح‌واره، name: رشته): منطقی
نرده‌ای یا شمارشی است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

نوع ممکن است IsPossibleType

تابع نوع ممکن است(s: طرح‌واره، abstractName: رشته، objectName: رشته): منطقی
نوع شیء می‌تواند جای این رابط یا اجتماع بنشیند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

انواع ممکن PossibleTypes

تابع انواع ممکن(s: طرح‌واره، name: رشته): وکتور<رشته>
نوع‌های شیئی که جای رابط یا اجتماع می‌نشینند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

نام نوع ریشه RootTypeName

تابع نام نوع ریشه(s: طرح‌واره، optype: صحیح): رشته
نام نوع ریشه‌ی یک عملیات.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

طرح‌واره جدید NewSchema

تابع طرح‌واره جدید(): طرح‌واره
طرح‌واره‌ی خالی با نوع‌های نرده‌ای و دستورالعمل‌های استاندارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

متن ارجاع نوع TypeRefText

تابع متن ارجاع نوع(sch &: طرح‌واره، text: رشته): صحیح
متن ارجاع نوع، مثل [Int!]، را در طرح‌واره ثبت می‌کند و شماره‌اش را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن نوع اسکالر AddScalarType

تابع افزودن نوع اسکالر(sch &: طرح‌واره، name: رشته، description: رشته)
نوع نرده‌ای می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن نوع شیء AddObjectType

تابع افزودن نوع شیء(sch &: طرح‌واره، name: رشته، description: رشته)
نوع شیء می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن نوع رابط AddInterfaceType

تابع افزودن نوع رابط(sch &: طرح‌واره، name: رشته، description: رشته)
رابط می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن نوع ورودی AddInputObjectType

تابع افزودن نوع ورودی(sch &: طرح‌واره، name: رشته، description: رشته)
نوع ورودی می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن نوع شمارشی AddEnumType

تابع افزودن نوع شمارشی(sch &: طرح‌واره، name: رشته، values: وکتور<رشته>)
نوع شمارشی با مقدارها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن نوع اجتماع AddUnionType

تابع افزودن نوع اجتماع(sch &: طرح‌واره، name: رشته، members: وکتور<رشته>)
اجتماع با اعضا.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن رابط به AddInterfaceTo

تابع افزودن رابط به(sch &: طرح‌واره، typeName: رشته، interfaceName: رشته)
رابطی را به فهرست رابط‌های یک نوع می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن فیلد AddField

تابع افزودن فیلد(sch &: طرح‌واره، typeName: رشته، fieldName: رشته، typeText: رشته): منطقی
فیلدی با متن نوع، مثل [Book!]!، می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن آرگومان فیلد AddFieldArg

تابع افزودن آرگومان فیلد(sch &: طرح‌واره، typeName: رشته، fieldName: رشته، argName: رشته، typeText: رشته): منطقی
آرگومانی به فیلد می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

افزودن فیلد ورودی AddInputField

تابع افزودن فیلد ورودی(sch &: طرح‌واره، typeName: رشته، fieldName: رشته، typeText: رشته): منطقی
فیلدی به نوع ورودی می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

تعیین انواع ریشه SetRootTypes

تابع تعیین انواع ریشه(sch &: طرح‌واره، queryType: رشته، mutationType: رشته، subscriptionType: رشته)
نوع‌های ریشه را تعیین می‌کند؛ رشته‌ی خالی یعنی ندارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

آزادسازی طرح‌واره FreeSchema

تابع آزادسازی طرح‌واره(sch &: طرح‌واره)
طرح‌واره را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Schema.salam

اعتبارسنجی Validate

تابع اعتبارسنجی(sch: طرح‌واره، doc: سند): فهرست خطا
سند را با طرح‌واره اعتبارسنجی می‌کند: فیلدهای ناموجود، گونه‌ی آرگومان‌ها، متغیرهای تعریف‌نشده و مانند آن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

اعتبارسنجی موفق ValidateOk

تابع اعتبارسنجی موفق(sch: طرح‌واره، doc: سند): منطقی
سند معتبر است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

اعتبارسنجی منبع ValidateSource

تابع اعتبارسنجی منبع(sch: طرح‌واره، source: رشته): فهرست خطا
متن را تجزیه و اعتبارسنجی می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Document.salam

تعیین حل‌کننده SetResolver

تابع تعیین حل‌کننده(sch &: طرح‌واره، typeName: رشته، fieldName: رشته، fn: صحیح۶۴): منطقی
تابعی را برای فیلد یک نوع ثبت می‌کند؛ تابع شماره‌ی شکاف را می‌گیرد. فیلد بی حل‌کننده مقدار هم‌نام شیء والد را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

حل‌کننده دارد HasResolver

تابع حل‌کننده دارد(sch: طرح‌واره، typeName: رشته، fieldName: رشته): منطقی
فیلد حل‌کننده دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

والد Parent

تابع والد(slot: صحیح۶۴): مقدار.مقدار
شیء والد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

آرگومان‌ها Args

تابع آرگومان‌ها(slot: صحیح۶۴): مقدار.مقدار
آرگومان‌ها به شکل شیء.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Internals.salam

زمینه Context

تابع زمینه(slot: صحیح۶۴): مقدار.مقدار
زمینه‌ای که به اجرا داده شده؛ مثلاً کاربر واردشده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

نام فیلد FieldName

تابع نام فیلد(slot: صحیح۶۴): رشته
نام فیلد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

نام نوع والد ParentTypeName

تابع نام نوع والد(slot: صحیح۶۴): رشته
نام نوع والد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

آرگومان دارد HasArg

تابع آرگومان دارد(slot: صحیح۶۴، name: رشته): منطقی
آرگومان آمده است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

آرگومان Arg

تابع آرگومان(slot: صحیح۶۴، name: رشته): مقدار.مقدار
آرگومان به شکل مقدار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

آرگومان عددی ArgInt

تابع آرگومان عددی(slot: صحیح۶۴، name: رشته): صحیح۶۴
آرگومان عددی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

آرگومان اعشاری ArgFloat

تابع آرگومان اعشاری(slot: صحیح۶۴، name: رشته): اعشار۶۴
آرگومان اعشاری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

آرگومان رشته ArgStr

تابع آرگومان رشته(slot: صحیح۶۴، name: رشته): رشته
آرگومان رشته.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

آرگومان بولی ArgBool

تابع آرگومان بولی(slot: صحیح۶۴، name: رشته): منطقی
آرگومان بولی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

فیلد والد ParentField

تابع فیلد والد(slot: صحیح۶۴، name: رشته): مقدار.مقدار
فیلدی از شیء والد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

حل Resolve

تابع حل(slot: صحیح۶۴، v: مقدار.مقدار)
نتیجه را با یک مقدار تعیین می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

حل عددی ResolveInt

تابع حل عددی(slot: صحیح۶۴، n: صحیح۶۴)
نتیجه‌ی عددی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

حل اعشاری ResolveFloat

تابع حل اعشاری(slot: صحیح۶۴، f: اعشار۶۴)
نتیجه‌ی اعشاری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

حل رشته ResolveStr

تابع حل رشته(slot: صحیح۶۴، s: رشته)
نتیجه‌ی رشته.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

حل بولی ResolveBool

تابع حل بولی(slot: صحیح۶۴، b: منطقی)
نتیجه‌ی بولی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

حل تهی ResolveNull

تابع حل تهی(slot: صحیح۶۴)
نتیجه‌ی تهی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

شکست Fail

تابع شکست(slot: صحیح۶۴، message: رشته)
فیلد را با خطا تمام می‌کند؛ فیلد تهی می‌شود و خطا با مسیرش در پاسخ می‌آید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

بازنشانی شکاف‌ها ResetSlots

تابع بازنشانی شکاف‌ها()
شکاف‌های حل‌کننده را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Execute.salam

ساخت بدنه درخواست BuildRequestBody

تابع ساخت بدنه درخواست(queryText: رشته، operationName: رشته، variables: مقدار.مقدار): رشته
بدنه‌ی جیسون درخواست POST.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

ساخت بدنه پرس‌وجو BuildQueryBody

تابع ساخت بدنه پرس‌وجو(queryText: رشته): رشته
بدنه‌ی جیسون فقط با پرسمان.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

ساخت رشته پرس‌وجو BuildRequestQueryString

تابع ساخت رشته پرس‌وجو(queryText: رشته، operationName: رشته، variables: مقدار.مقدار): رشته
رشته‌ی پرسمان برای درخواست GET.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

تجزیه پاسخ ParseResponse

تابع تجزیه پاسخ(body: رشته): پاسخ کارخواه
پاسخ جیسون سرور را می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

فیلد پاسخ ResponseField

تابع فیلد پاسخ(r: پاسخ کارخواه، name: رشته): مقدار.مقدار
فیلدی از داده‌ی پاسخ.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

پاسخ موفق ResponseOk

تابع پاسخ موفق(r: پاسخ کارخواه): منطقی
پاسخ خطا ندارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

پیام خطای پاسخ ResponseErrorMessage

تابع پیام خطای پاسخ(r: پاسخ کارخواه): رشته
پیام نخستین خطا.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam

آزادسازی پاسخ کارخواه FreeClientResponse

تابع آزادسازی پاسخ کارخواه(r &: پاسخ کارخواه)
پاسخ را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: graphql-Http.salam