อ่านประมาณ 8 นาที
ระดับกลาง
หมวด: เว็บ
อ้างอิง: Cloudflare Blog — How we rebuilt Cloudflare Workers' module registry for Node.js compatibility
ทีมที่เคยย้ายโค้ด Node.js ขึ้น Cloudflare Workers แล้วเจอไลบรารีที่เรียก import.meta.resolve() หรือพึ่งพฤติกรรม require() แบบ Node พังกลางทาง มีทางออกแล้ว Cloudflare เขียน module registry ส่วนที่ค้นหา โหลด และคอมไพล์โมดูลของ Workers ใหม่ ให้มองตัวระบุโมดูลเป็น URL ตามมาตรฐาน คอมไพล์เฉพาะโมดูลที่ถูกเรียกจริง และทำตัวใกล้ Node.js ขึ้น ระบบใหม่ต้องเปิดเองด้วยแฟล็ก บทความนี้สรุปว่าอะไรเปลี่ยน อะไรอาจทำให้โค้ดเดิมสะดุด และควรทดลองอย่างไร
module registry ทำหน้าที่อะไร
ข้อความหลังคำสั่ง import หรือ require เช่น './utils.js' หรือ 'node:fs' เรียกว่าตัวระบุโมดูล (specifier) ต้องมีผู้แปลงเป็นโค้ดจริง คอมไพล์ แล้วส่งให้เอนจิน V8 รัน ใน workerd ซึ่งเป็นแกนโอเพนซอร์สของ Workers ผู้ทำงานนี้คือ module registry
เดิมบทบาทนี้ดูไม่สำคัญ เพราะ Wrangler ใช้ esbuild รวมเกือบทุกอย่างเป็นไฟล์เดียว แต่ Vite 8 ที่ใช้ Rolldown แยกผลลัพธ์เป็นหลายโมดูล โมดูล Node.js ที่ import ก็อยู่ใน workerd ไม่ใช่ polyfill และการ deploy ด้วย --no-bundle ส่งกราฟโมดูลไปทุกไฟล์ registry จึงสำคัญขึ้น
ระบบเดิมติดอยู่ตรงไหน
อาการที่นักพัฒนาเจอคือโค้ดที่เรียก import.meta.resolve() ล้มทันที ต้นเหตุคือระบบเดิมไม่ได้ถือว่าตัวระบุเป็น URL แต่ปฏิบัติเหมือนพาธของไฟล์ จึงไม่มีทางทำ import.meta.url ให้ถูกต้องได้ โปรโตคอลอย่าง node: และ cloudflare: ต้องเขียนเป็นข้อยกเว้นทีละกรณี และการ import แบบสัมพัทธ์ก็คำนวณคนละกฎกับ new URL() บทเรียนคือเลือกตามมาตรฐานตั้งแต่วันแรกถูกกว่าแก้ทีหลัง
ด้านประสิทธิภาพ ระบบเดิมคอมไพล์ทั้งบันเดิลตั้งแต่เริ่ม และ isolate ของ V8 (สภาพแวดล้อมรันโค้ดที่แยกจากกัน) แต่ละชุดที่รัน Worker เดียวกันบนหลายคอร์มีสำเนาของตัวเอง ซอร์สเดียวกันจึงถูกคอมไพล์และเก็บซ้ำ ระบบใหม่ออกแบบให้คอมไพล์เมื่อถูก import ครั้งแรกและแบ่งปันแคชตั้งแต่ต้น ส่วนระบบเดิมยังอยู่ Worker ที่ deploy แล้วทำงานเหมือนเดิม
เปิดแฟล็กแล้วได้อะไร
import.meta ครบ — import.meta.url คืน URL ของโมดูล import.meta.main เป็นจริงเฉพาะโมดูลที่เป็นจุดเริ่มของ Worker และ import.meta.resolve() แปลงตัวระบุเป็น URL โดยไม่โหลดจริงตัวระบุเป็น URL จริง — ใช้ URL เต็มได้ และรองรับ query string กับ fragmentrequire(esm) ตามกฎ Node.js — ทั้งใน CommonJS และผ่าน createRequire()ตรวจ import attribute จริง — ตอนนี้รองรับเฉพาะ type: 'json' ข้อเสนอเดียวที่ถึง Stage 4 ของ TC39WebAssembly แบบ source phase — import source mod from './add.wasm' ได้ WebAssembly.Module ที่คอมไพล์แล้วแต่ยังไม่สร้างอินสแตนซ์ข้อผิดพลาดแบบเดียวกันทุกทาง — หาไม่เจอเป็น Error ตัวระบุที่แปลงเป็น URL ไม่ได้เป็น TypeError ไม่ว่าโหลดด้วยวิธีใด
จุดที่อาจทำให้โค้ดเดิมสะดุด
การทำตามมาตรฐานเคร่งขึ้นแปลว่าโค้ดที่เคยรอดเพราะระบบเดิมมองข้าม อาจเริ่มโยนข้อผิดพลาด ควรไล่ตรวจก่อนเปิดแฟล็ก
attribute ที่ระบบเดิมเพิกเฉยเงียบ ๆ เช่น type: 'text' หรือ 'bytes' จะได้ TypeError ว่ายังไม่รองรับ คีย์อื่นนอกจาก type ก็ผิด import ไฟล์เดียวกันด้วย query string ต่างกัน เช่น ./store.js?a กับ ./store.js?b ได้โมดูลสองชุดที่มีตัวแปรระดับบนแยกกัน ถ้าโค้ดเคยต่อ query string เพื่อเลี่ยงแคช ค่าที่ควรมีชุดเดียวอาจแตกเป็นหลายชุด require() โมดูลที่มี top-level await ในกราฟจะ throw ทันที เหมือน ERR_REQUIRE_ASYNC_MODULE ของ Node.js ให้ใช้ import() แทน
ลองใช้อย่างไร และอะไรได้ทันทีโดยไม่ต้องเปิดแฟล็ก
เพิ่ม new_module_registry ในรายการ compatibility_flags ของไฟล์ตั้งค่า Wrangler แฟล็กนี้ยังไม่มีวันที่เปิดเป็นค่าเริ่มต้น จึงไม่ถูกเปิดให้เองไม่ว่า compatibility date จะเป็นวันไหน
ส่วนที่มีผลทันทีคือ Workers รองรับ API ที่เสถียรของ Node.js ที่ใช้ได้ในบริบท serverless ครบและเปิดเป็นค่าเริ่มต้น ขนาดแอปขยายเป็น 64 MiB ทุกแผน และยกเลิกเพดานขนาดบันเดิลหลังบีบอัด
สำหรับทีมพัฒนาเว็บในไทยที่ใช้ Workers หรือกำลังพิจารณาย้ายระบบขึ้นแพลตฟอร์มไร้เซิร์ฟเวอร์ การเปิดแฟล็กนี้ในสภาพแวดล้อมทดสอบก่อนคือขั้นตอนที่ควรทำ เพราะพฤติกรรมการแปลงตัวระบุที่เปลี่ยนไปอาจกระทบไลบรารีที่พึ่งพารูปแบบเดิม และควรตรวจให้ครบก่อนใช้กับระบบจริง ทีมงาน Smart Cyber Tech รับทำเว็บไซต์และเว็บแอปพลิเคชัน React และ Next.js รวมถึงวางระบบบนแพลตฟอร์มขอบเครือข่ายให้รองรับผู้ใช้จำนวนมากโดยคุมค่าใช้จ่ายได้ ปรึกษาได้ที่ แบบฟอร์มติดต่อ
สรุปสาระสำคัญ module registry ทำหน้าที่อะไร ระบบเดิมติดอยู่ตรงไหน เปิดแฟล็กแล้วได้อะไร
แหล่งอ้างอิง เรียบเรียงจาก Cloudflare Blog — How we rebuilt Cloudflare Workers' module registry for Node.js compatibility —
อ่านบทความต้นฉบับ ภาพปก: Cloudflare Blog · ลิขสิทธิ์ภาพเป็นของเจ้าของต้นฉบับ ใช้ประกอบการรายงานพร้อมอ้างอิงแหล่งที่มา
มีคำถามเพิ่มเติมเกี่ยวกับบทความนี้? เขียนหาเราได้ที่
info@smart-cyber-tech.com
บริการที่เกี่ยวข้องจากทีมงาน Smart Cyber Tech
แบ่งปันบทความนี้:
LINE
Facebook
X
คัดลอกลิงก์
ปรึกษาทีมของเรา