connect es

เชื่อมต่อสำหรับ ecmascript

Connect เป็นตระกูลของห้องสมุดสำหรับการสร้าง APIs-safe-safe ที่มีภาษาและแพลตฟอร์มที่แตกต่างกัน @connectrpc/Connect นำไปสู่ TypeScript, เว็บเบราว์เซอร์และไปยัง Node.js.

ด้วยการเชื่อมต่อคุณกำหนดสคีมาก่อน:

 service ElizaService {
  rpc Say(SayRequest) returns (SayResponse) {}
}

และด้วยความมหัศจรรย์ของการสร้างรหัสสคีมานี้สร้างเซิร์ฟเวอร์และลูกค้า:

 const answer = await eliza . say ( { sentence : "I feel happy." } ) ;
console . log ( answer ) ;
// {sentence: 'When you feel happy, what do you do?'}

ซึ่งแตกต่างจากที่เหลือการโทรขั้นตอนระยะไกลนั้นปลอดภัย แต่เป็น HTTP ปกติภายใต้ประทุน คุณสามารถดูคำขอทั้งหมดในผู้ตรวจสอบเครือข่ายและคุณสามารถ curl หากคุณต้องการ:

curl 
    --header ' Content-Type: application/json ' 
    --data ' {"sentence": "I feel happy."} ' 
    https://demo.connectrpc.com/connectrpc.eliza.v1.ElizaService/Say

Connect ใช้ Protobuf-ES ซึ่งเป็นไลบรารี JavaScript Protobuf ที่เข้ากันได้อย่างสมบูรณ์เท่านั้น

เชื่อมต่อใช้โปรโตคอล RPC สาม: โปรโตคอล GRPC และ GRPC-WEB ที่มีอยู่อย่างกว้างขวางและโปรโตคอลของ Connect ของตัวเองที่ได้รับการปรับให้เหมาะสมสำหรับเว็บ สิ่งนี้จะช่วยให้คุณมีการทำงานร่วมกันที่ไม่มีใครเทียบได้ในหลายแพลตฟอร์มและภาษาด้วยความปลอดภัยแบบ end-to-end

เริ่มต้นบนเว็บ

ติดตามการสอน 10 นาทีของเราที่เราใช้ Vite และตอบสนองเพื่อสร้างเว็บอินเตอร์เฟสสำหรับ Eliza

รองรับ React , Svelte , Vue , Next.js และ Angular (ดูตัวอย่าง) และเรามีชุดขยายสำหรับการสืบค้น tanstack เรารองรับเว็บเบราว์เซอร์ที่ทันสมัยทั้งหมดที่ใช้ API Fetch ที่มีอยู่และ API การเข้ารหัสอย่างกว้างขวาง

เริ่มต้นที่ node.js

ติดตามการสอน 10 นาทีของเราเพื่อหมุนบริการใน node.js และเรียกมันจากเว็บและจากไคลเอนต์ GRPC ในเทอร์มินัลของคุณ

คุณสามารถให้บริการ RPC แบบเชื่อมต่อของคุณด้วย vanilla node.js หรือใช้ปลั๊กอินเซิร์ฟเวอร์ของเราสำหรับ Fastify , next.js และ Express เรารองรับ Node.js v18.14.1 และต่อมาด้วยโมดูล http และ http2 ในตัว

การย้ายจากเวอร์ชัน 1

หากคุณย้ายจาก V1 เป็น V2 ให้ตรวจสอบคู่มือการย้ายถิ่นของเรา

แพลตฟอร์มอื่น ๆ

คุณต้องการใช้ Connect บนแพลตฟอร์มอื่น ๆ เช่น Bun, Deno, Vercel's Edge Runtime หรือ CloudFlare Workers หรือไม่? เราชอบที่จะเรียนรู้เกี่ยวกับกรณีการใช้งานของคุณและสิ่งที่คุณต้องการทำกับ Connect คุณสามารถติดต่อเราได้ทั้งผ่าน BUF Slack หรือโดยการยื่นปัญหา GitHub และเรายินดีที่จะแชทมากกว่า!

แพ็คเกจ

• @connectrpc/Connect: ไคลเอนต์ RPC และเซิร์ฟเวอร์สำหรับสคีมาของคุณ (ซอร์สโค้ด)
• @ConnectrPC/Connect-Web: อะแดปเตอร์สำหรับเว็บเบราว์เซอร์และแพลตฟอร์มอื่น ๆ ที่มี API Fetch บนกระดาน
• @connectrpc/connect-node: เสิร์ฟ rpcs บนเซิร์ฟเวอร์วานิลลา node.js โทร RPCs ด้วยโปรโตคอลใด ๆ
• @ConnectrPC/Connect-Fastify: เสียบบริการของคุณเข้ากับเซิร์ฟเวอร์ Fastify
• @connectrpc/connect-next: ให้บริการ RPC ของคุณด้วยเส้นทาง next.js API
• @ConnectrPC/Connect-Express: เพิ่มบริการของคุณลงในเซิร์ฟเวอร์ด่วน

ไลบรารีและรหัสที่สร้างขึ้นเข้ากันได้กับ ES2017 และ TypeScript 4.9.5

ระบบนิเวศ

• ตัวอย่าง-: ตัวอย่างสำหรับการใช้การเชื่อมต่อกับเฟรมเวิร์กเว็บและเครื่องมือประเภทต่างๆ
• Connect-Query-ES: TypeScript First Expansion Pack สำหรับการสืบค้น tanstack ที่ให้พลังมหาอำนาจ Protobuf
• Connect-Playwright-ES: การทดสอบนักเขียนบทละครสำหรับแอปพลิเคชัน Connect ของคุณ
• Connect-Swift: สำนวน GRPC & เชื่อมต่อ RPCS สำหรับ Swift
• Connect-Go: ไปใช้งาน GRPC, GRPC-WEB และ Connect
• ตัวอย่าง-GO: ตัวอย่างการให้บริการ RPC Powering https://demo.connectrpc.com
• ความสอดคล้อง: GRPC-WEB และเชื่อมต่อการทดสอบการทำงานร่วมกัน
• BUF Studio: Web UI สำหรับ Ad-Hoc RPCS

ถูกกฎหมาย

เสนอภายใต้ใบอนุญาต Apache 2