GraphiQL 6 thiết kế lại giao diện và đổi cách gửi yêu cầu

11 tháng 11, 2026 · Ban biên tập BehindLines

GraphiQL, công cụ để viết và thử truy vấn GraphQL ngay trong trình duyệt, đã lên phiên bản 6. Theo thông báo do Trevor Scheer đăng ngày 7 tháng 11 năm 2026 trên blog graphql.org, công việc này được tài trợ qua chương trình tài trợ cộng đồng GraphQL. Trang phát hành trên GitHub ghi ngày của bản 6.0.0 là 1 tháng 11.

Giao diện xây lại quanh các trình soạn thảo

Các trình soạn thảo đã chuyển sang Monaco từ phiên bản 5. Phiên bản 6 sắp xếp lại toàn bộ không gian làm việc: thanh điều hướng, các tab, menu và hộp thoại. Ghi chú phát hành nhắc đến giao diện sáng và tối, thanh điểm cuối, bảng bên có thể đổi kích thước và thanh trạng thái. Thông báo cũng cho biết dấu hiệu tiêu điểm bàn phím rõ hơn và các phép kiểm tra khả năng tiếp cận tự động nay chạy cùng những bài kiểm thử khác.

Ba tính năng mới cho công việc hằng ngày

Trình dựng truy vấn: chọn các trường từ schema và thao tác sẽ tự được viết vào trình soạn thảo. Người dùng có thể chuyển qua lại giữa trình dựng và văn bản, tách các trường thành một fragment có thể tái sử dụng, hoặc nâng một đối số thành biến.
Bộ sưu tập (Collections): thao tác được lưu theo tên, chia sẻ dưới dạng JSON và nhập vào mà không tạo bản trùng. Mặc định chúng nằm trong trình duyệt; một tổ chức có thể gắn kho lưu trữ riêng.
Ba cách xem phản hồi: JSON thô, dạng cây có thể thu gọn hoặc dạng bảng. Lựa chọn được giữ lại sau khi tải lại trang.

API transport dần thay thế fetcher

Thay đổi mang tính kỹ thuật nhất liên quan đến cách gửi yêu cầu. API `transport` mới trả về thông tin HTTP cùng kết quả: phương thức, trạng thái, thời gian và kích thước phản hồi. Để chọn phương thức, trước hết nó gửi yêu cầu OPTIONS và đọc tiêu đề `Allow`. Với thao tác đọc, nó ưu tiên QUERY, rồi POST, rồi GET; nếu việc dò tìm thất bại thì quay về POST, còn mutation luôn dùng POST. Dự án khuyên nên chuyển sang, nhưng `fetcher` vẫn dùng được và mới chỉ bị đánh dấu lỗi thời.

Cần kiểm tra gì trước khi nâng cấp

Thông báo không liệt kê các thay đổi gây gián đoạn mà dẫn tới một hướng dẫn chuyển đổi. Ghi chú phát hành thì kể ra nhiều điểm: graphql-js phiên bản 15 và từ 16.0 đến 16.10 không còn được hỗ trợ, plugin Explorer nhường chỗ cho trình dựng truy vấn, thuộc tính `operationName` bị gỡ bỏ, và các biến CSS `--color-*` cũ không còn tạo kiểu cho giao diện, được thay bằng token OKLCH. Với một tích hợp có sẵn, thông báo khuyên nên bắt đầu từ hướng dẫn chuyển đổi.