Share
Embed
Lookback TypeScript ESM support and what should we do now.
TSKaigi2025
- https://2025.tskaigi.org/talks/sajikix
X
- https://twitter.com/sajikix
Saji
May 24, 2025
Transcript
86 slides
-
͞ͳ͍͜ͱ🙏 ϒϥβͷTDSJQUλάͷ ͱ͍͏͔/PEFKTҎ֎ͷSVOUJNFͷ w /PEFKTͱ·ͨඍົʹҧ͏͕ग़ͯ͘ΔͷͰ 4PVSDF.BQͱ͔ CVOEMFSʹґଘͨ͠ग़ྗͷ w
͋͘·Ͱ/PEFKTͰ࣮ߦ͞ΕΔPS/PEFKTͰόϯυϧ͞ΕΔίʔυͷ ϞδϡʔϧγεςϜͷྺ࢙ͷਂ͍ -
͜ͷεϥΠυͰ͏༻ޠʹ͍ͭͯ $+4 $PNNPO+4 w /PEF͕࠾༻͍ͯ͠ΔϞδϡʔϧγεςϜɾߏจ w ΄Μͱ$PNNPO+4.PEVMFͱ͍͏ͷ͕ਖ਼֬ &4. &$."4DSJQU.PEVMF
w &$."4DSJQUͰఆٛ͞ΕͨϞδϡʔϧ༷ͷ͜ͱ w ݱࡏଟ͘ͷϥϯλΠϜͰղऍɾ࣮ߦՄೳ -
͜ͷεϥΠυͰ͏༻ޠʹ͍ͭͯ /BUJWF&4. w /PEFKTϒϥβͰ&4.ΛධՁɺղܾ͢Δํࣜɺ͓ΑͼͦͷϑΝΠϧ w ٖࣅ&4.ͱൺֱͯ͠ʮ/BUJWFʯ ٖࣅ&4. 'BVY&4.'BLF&4. w
$+4ม͢Δ͜ͱΛલఏʹॻ͔Εͨ&4.ͷܗࣜɾϑΝΠϧ w &4.ͷه๏ʹ४ڌ͢Δ͕ɺ/BUJWF&4.ͱඍົʹϧʔϧ͕ҧͬͨΓ͢Δ w ֦ுࢠলུ͢Δ͠ͳ͍ͱ͔ -
෮श $+4ͷه๏ *NQPSU &YQPSU ಛ$+4ಉظͳղܾɾ֦ுࢠΛলུͰ͖Δ const module = require("./module"); //
module શମ const { funcA, funcB } = require("./module"); // ෳimport module.exports = func; // 1ͭͷModule exports.funcA = ()=>{…} // named export -
෮श &4.ͷه๏ *NQPSU &YQPSU ಛ&4.Ͱඇಉظͳղܾɾ/BUJWF&4.Ͱ֦ுࢠΛলུͰ͖ͳ͍ import module from "./module.js";
// default import import { funcA } from "./module.js"; // named import export default function() {...}; // default export export const funcA = ()=> {...}; // named export -
&4.ͱ$+4ͷྺ࢙ ؆қ൛ w $PNNPO+4͕ఏҊ͞ΕɺͦͷϞδϡʔϧγεςϜΛ/PEFKT͕࠾༻ w ͦͷޙ/PEFKTฒͼʹपลΤίγεςϜ͕ීٴ XFC։ൃͷσϑΝΫτ
w 54͜ͷࠒੜ🎉 w &$."4DSJQU͕ʹݴޠඪ४ͱͯ͠ϞδϡʔϧγεςϜΛࡦఆ&4. w ֤SVOUJNF͕&4.ͷ࣮ߦΛTVQQPSU w /PEF KTW ओཁϒϥβ ͝Ζ w ͔͢͠͠Ͱʹ$+4ʹΑͬͯங͔Εͨࢿ࢈େ͖͘ɺ&4.ҠߦঃʑʹਐΉ -
/PEFͷ&4.αϙʔτ /PEF KT͕&4.ͷ࣮ߦΛαϙʔτͨ͠ W w ैདྷͷ$+4ʹՃ͑ͯ/BUJWF&4.ͳϑΝΠϧ࣮ߦͰ͖ΔΑ͏ʹ ৽͍֦͠ுࢠ.cjsͱ.mjs w .cjs໌ࣔతʹ$+4ͩͱએݴͰ͖Δ
w .mjs໌ࣔతʹ&4.ͩͱએݴͰ͖Δ &4.ͩͱͲ͏ͬͯݟ͚Δ͔ʁ w ֦ுࢠͰ໌ࣔతʹΘ͔Δ͔ʁˠQBDLBHFKTPOͷtypeˠ$+4 -
&4.αϙʔτ͢Δલͷ54 ٖࣅ&4.Ͱॻ͍͍͍ͯײ͡ʹ$PNNPOKTʹม͍ͯͨ͠ w ࣌$+4Ͱͳ͍ͱ/PEFͰಈ͔ͳ͍ͷϒϥβίʔυͲ͏ͤCVOEMF 54ʹ໌ࣔతʹ$+4τϥϯεύΠϧͯ͠Β͏ಠࣗه๏͋Δ import module = require("./module"); //
↓ transpile const module = require("./module") -
&4.ରԠ৽͍͠NPEVMFΦϓγϣϯ moduleΦϓγϣϯʹ"nodenext" node16node18 ͕ಋೖ w /PEFKTͷϞδϡʔϧղܾϧʔϧʹ४ڌˠ/PEFWҎ߱ͳΒڧ͘ਪ˞ w ֦ுࢠQBDLBHFKTPOͷ"type"Λݟͯղܾํ๏ͱग़ྗஅ w ΠϯϙʔτύεͰ֦ுࢠলུͰ͖ͳ͍
w UPQMFWFMBXBJU%ZOBNJD*NQPSUΛར༻Ͱ͖Δ ˞IUUQTXXXUZQFTDSJQUMBOHPSHEPDTIBOECPPLNPEVMFTUIFPSZIUNMNPEVMFSFTPMVUJPO import module from "./module" // ❌ -
54ͷ&4.ରԠ৽͍͠NPEVMFΦϓγϣϯ "nodenext"ͱ"node16ɾ18"ͱԿ͕ҧ͏ʁ w "node16ɾ18"ͦΕͧΕͷόʔδϣϯͰ҆ఆͨ͠ϞδϡʔϧγεςϜͷڍಈ w "nodenext"࠷৽όʔδϣϯʹ߹ΘͤͯಈతʹมΘΔ w Α΄Ͳݹ͍/PEFKTΛͬͯͳ͍ݶΓ"nodenext"Ͱྑͦ͞͏ 5BSHFU *NQPSU
BTTFSUJPOT *NQPSU BUUSJCVUF SFRVJSF JTN /PEF FT ❌ ❌ ❌ /PEF FT ✅ ❌ ❌ OPEFOFYU FTOFYU ❌ ✅ ✅ -
54ͷ&4.ରԠ৽͍֦͠ுࢠͷಋೖ `.mts` ͱ`.cts`ͱ͍͏৽͍͠ϑΝΠϧ֦ுࢠ͕ಋೖ w .mtsϑΝΠϧίϯύΠϧ࣌ʹ&4.ܗࣜͷNKTϑΝΠϧͱͯ͠ग़ྗ w .ctsϑΝΠϧίϯύΠϧ࣌ʹ$+4ܗࣜͷDKTϑΝΠϧͱͯ͠ग़ྗ w ಉ༷ʹܕఆٛϑΝΠϧ.mtsˠ.d.mts .ctsˠ.d.ctsͷΑ͏ʹͳΔ
Πϯϙʔτύεͷ֦ுࢠ࣮ߦ࣌ʹղܾ͞ΕΔ+BWB4DSJQUϑΝΠϧͷ֦ுࢠ w ྫ͑ɺ./add.ts → ./add.js, ./add.mts → ./add.mjs -
54ͷ&4.ରԠؔ࿈͢ΔΦϓγϣϯ moduleResolutionར༻͢ΔϞδϡʔϧղܾΞϧΰϦζϜͷϞσϧ w ͷʹΑͬͯNPEVMFΦϓγϣϯʹΑͬͯڧ੍͞ΕΔ moduleΦϓγϣϯ͕OPEFܥͷ߹ w module: "node16"PS"node18"ˠmoduleResolution: "node16" w
module: "nodenext"ˠmoduleResolution: "nodenext" w ࠓͷॴ"node16""nodenext" ʹࠩͳ͍ w node16ݻఆ͞Ε͍ͯΔ͕ɺnodenextಈతʹมߋ͞ΕΔՄೳੑ͋Γ -
EFGBVMUFYQPSU EFGBVMUFYQPSUʹରԠ͢Δߏจͷ෦ͷϛεϚον w $+4module.exports ͕EFGBVMUFYQPSU w &4.EFGBVMUFYQPSU"default"ͱ͍͏໊લͷOBNFEFYQPSU ٖࣅ&4. .ctsͳͲ Ͱ&4.ͷϧʔϧͰॻ͖ग़͢ˠmodule.default
= /PEF͕&4.͔Β$+4ΛJNQPSU͢Δͱ͖$+4ͷϧʔϧˠmodule.exports w ˠ͋Εղऍҧͬͯͳ͍ʁ -
54ͷFT.PEVMF*OUFSPQΦϓγϣϯ ग़ྗ͢Δ$+4ίʔυͱ֎෦&4.ͱͷ૬ޓӡ༻ੑΛ্͛ΔΦϓγϣϯ w EFGBVMUFYQPSUʹҰఆͷղܾΛͨΒ͢ͷ 5SVFʹ͢Δͱʜ w $+4τϥϯεύΠϧ͢ΔࡍʹΠϯϙʔτॲཧΛ࡞ w __esModuleϑϥάΛ͚ͭɺͦͷ࣍ୈͰJNQPSUॲཧΛม͑Δ w
__esModule ͕trueEFGBVMUϓϩύςΟ͕EFGBVMUFYQPSU w __esModule ͕falseNPEVMFFYQPSUT͕EFGBVMUFYQPSU -
ಉظɾඇಉظ $+4ͷSFRVJSFಉظత ↔︎ &4.ͷJNQPSUඇಉظ w &4.͔Β$+4ΛಡΉ͜ͱجຊͳ͍ w $+4͔Β&4.ΛಡΉ͕࣌໘ $+4͔Β&4.ΛಡΉํ๏ w
EZOBNJD*NQPSU&4.ΛಡΉجຊతͳํ๏ w 🆕SFRVJSF &4. ಉظͰ&4.ΛಡΊΔػೳ ੍ݶ͋Γ -
EZOBNJD*NQPSU &$."4DSJQUϞδϡʔϧΛಡΈࠐΊΔΑ͏ʹ͢Δؔ෩ͷࣜ w ඇಉظಈతͳಡΈࠐΈ w /PEFW͔Βར༻Ͱ͖Δ ਖ਼ࣜͳ༷͕ͩɺඇಉظʹͳΓߏจ͕େ͖͘มΘΔͷखؒ const mod =
await import("./lib.js"); // ಈతͳύεͰOK const mod2 = await import(`${env}/lib.js`); -
SFRVJSF &4. /PEFKTͰ&4.ΛಉظతʹಡΈࠐΊΔػೳ w /PEFKTͷWҎ࣮߱ݧతʹαϙʔτˠWͰ҆ఆ൛ͱͯ͠ϦϦʔε ͋Εɺ&4.ಉظతʹղܾͰ͖ͳ͍Μ͡Ό w ˠUPQMFWFM"XBJU͕͑ͳ͍ͱ͍͏੍ݶ͖ͭ શମ͕ඇಉظʹͳΔͷͰ
const mod = require("./lib.js") // ಈతͳύεͰOK const mod2 = require(`${env}/lib.js`) -
+4࣮ߦ࣌ͷύεΛ54ʹॻ͘ҧײʜ ݪଇ54ͰJNQPSUQBUI.jsͰॻ͔ͳ͍ͱ͍͚ͳ͍ w 5ZQF4DSJQUଆ͕SVOUJNFͷڍಈΛࠨӈ͍͚ͯ͠ͳ͍ͱ͍͏ݪଇ KTϑΝΠϧΛు͔ͳ͍ͷͰ͋ΕUTͰJNQPSUͯ͠ྑ͍ͷͰʁ w —allowImportingTsExtensionsΦϓγϣϯ 54Ҏ߱ w
ͨͩ͠ɺnoEmit : trueͰͳ͍ͱ͍͚ͳ͍ KTΛు͔ͳ͍ // app.ts import { cjsNamedExport } from "./cjsModule.js"; // .js -
సػ/PEFKTͷ54࣮ߦػೳ͕͖ͨ /PEFKTͷ—experimental-strip-typeΦϓγϣϯ GSPN/PEFW w ͜ͷΦϓγϣϯͰUTͰJNQPSU͠ͳ͍ͱ͍͚ͳ͍ w ෦తʹ48$ͰτϥϯεύΠϧ͍ͯ͠Δ Ͱ54ͷ੍ͰʮUTͰJNQPSUKTΛు͔ͳ͍ʯ
࣮ߦଆͷ0QUJPO࣍ୈͰ.jsʹग़ྗ͍ͨ͠PS.tsͷ··͕͔ΕΔ🤔 ˠʮ+4ʹτϥϯεύΠϧ͠ͳ͍ͳΒ.tsͰ͍͍Αʯͱ͍͏લఏͷ่յ -
ॾਕͷSFXSJUF3FMBUJWF*NQPSU&YUFOTJPOT JNQPSU1BUIΛ.tsͰॻ͍ͯ.jsʹॻ͖͑ͯ͘ΕΔΦϓγϣϯ ੍JNQPSU͚ͩͰݟͯػցతʹ֦ுࢠΛม͑ΒΕͳ͍ͱར༻Ͱ͖ͳ͍ w ❌ಈతʹJNQPSUQBUIΛม͑ΔΑ͏ͳ߹αϙʔτ͠ͳ͍ w ❌4VC1BUIJNQPSUTαϙʔτ͠ͳ͍ import { cjsNamedExport
} from "./cjsModule.ts"; // ↓ import { cjsNamedExport } from "./cjsModule.js"; -
UT֦ுΛ͚ͭΔ͜ͱʹର͢Δ̏͘͢Έ Կ͔ΛऔΖ͏ͱ͢ΔͱԿ͔Λࣺͯͳ͍ͱ͍͚ͳ͍😭 w ૉʹ KTͰ͔͘ w ˠ❌/PEFͰ54Λ࣮ߦͰ͖ͳ͍ w --allowImportingTsExtensions༗ޮ w
ˠ❌+4ʹॻ͖ग़͢͜ͱͰ͖ͳ͍ ܕఆٛϑΝΠϧ w --rewriteRelativeImportExtensions༗ޮ w ˠ❌ಈతʹJNQPSUTVCQBUIJNQPSU͑ͳ͍ -
֦ுࢠলུ ٖࣅ&4. Λଓ͚Δಓ moduleResolution: bundlerόϯυϥͰ͏͜ͱΛલఏͱͨ͠0QUJPO w όϯυϥʔΛར༻͢Δ߹ͦΕΛ໌ࣔ͢Δ͜ͱͰ֦ுࢠΛলུͰ͖Δ w ͨͩ͠ɺmoduleΦϓγϣϯ"esnext"͔"preserve"͔͠બͳ͍ w
$+4ʹॻ͖ग़͠Ͱ͖ͳ͍ w OPEFޓͷڍಈ࣮ݱͰ͖ͳ͍ w CVOEMFSͤʹͳΔ -
खॻ͖ܕఆٛϑΝΠϧ 54ܕఆٛϑΝΠϧΛղऍ͢Δࡍ54ϑΝΠϧಉ༷ɺҎԼͷΑ͏ʹผ͢Δ w ϑΝΠϧͷ֦ுࢠ.d.mts ˠ&4.ͷܕఆٛ.d.ctsˠ$+4ͷܕఆٛ w ࠷͍ۙQBDLBHFKTPOͷ"type" w ී௨UTDͰܕఆٛϑΝΠϧΛੜ͢Δˠ+4ͱܕఆٛϑΝΠϧର खॻ͖ͰEUTΛॻ͍ͯ%F
fi OJUFMZ5ZQFEʹొ͍ͯ͠ΔΑ͏ͳ߹ w ʮܕఆٛϑΝΠϧͷܗ͕ࣜ$+4ͳͷʹ&4.ͰಡΜ͡Ό͏ʯ͕ൃੜ͢Δ -
શମͰݴ͑Δ͜ͱ جຊతʹ৽͘͠࡞Δͷ&4.ͰॳΊΑ͏ w &4.ݴޠඪ४Ͱ͋Γओྲྀ&4.͔Β$+4ΛಡΉํָ͕ ˠQBDLBHFKTPOͷtype"module"ʹ͠ͱ͜͏ ͳΔ͘EFGBVMUFYQPSUΛආ͚Α͏ w ઌड़ͷΑ͏ʹ$+4 ↔︎ &4.ʹ͓͍ͯհͳ͜ͱ͕ଟ͍ͷͰආ͚Δ͕٢
ͳΔ͘UPQMFWFMBXBJUΛආ͚Α͏ w UPQMFWFMBXBJUΛͯ͠͠·͏ͱrequire(ESM)Ͱ͖ͳ͍ -
WFSCBUJN.PEVMF4ZOUBYΦϓγϣϯ verbatimModuleSyntaxΦϓγϣϯ 54d w 5ZQF4DSJQUͷJNQPSUFYQPSUͷڍಈΛஞޠతʹ͢Δ0QUJPO w ஞޠతJNQPSUΛʮͦͷ··ʯτϥϯεύΠϧ͢Δ w JNQPSU͞ΕΔͷ͕͔ܕΛ໌ࣔతʹॻ͘Α͏ڧ੍͞ΕΔ
w ⚠$PNNPO+4ग़ྗͩͱJNQPSUFYQPSUߏจ͕ېࢭ ஞޠత͡Όͳ͍ ˠ'VMM&4.ͳΒ0/ʹͨ͠ํ͕ྑͦ͞͏ 0QJOJPO import type { FuncA } from "./module.js"; -
#SPXTFSΞϓϦέʔγϣϯίʔυͷ߹ #VOEMFSΛͳ͘͢બݱঢ়ͳ͍ͱࢥ͍ͬͯΔ 0QJOJPO w ଟ͘ͷϞμϯ#SPXTFSͰ&4.Λղऍɾ࣮ߦͰ͖Δ w ͕ɺݱ࣮ύϑΥʔϚϯεͳͲΛߟ͑Δͱ#VOEMFඞཁͦ͏ ਖ਼#VOEMFSͷαϙʔτ࣍ୈɾOPEF͚ͷΦϓγϣϯ͏ඞཁͳ͍ ٯʹݫ֨ͳ&4.
㱠ٖࣅ&4. Λపఈ͢ΔϞνϕΊ w ͱ͍͑ࠓޙͷ͜ͱΛߟ͑Δͱ&4.ʹ͍ͯͬͨ͠ํ͕͍͍͚Ͳ w QBDLBHFKTPOͷtype: "module" WJUFͳͲͰXBSOJOH͕ग़Δ -
#SPXTFSΞϓϦέʔγϣϯίʔυͷઃఆ ඞਢ w "moduleResolution" : "bundler"ʹ͢Δͷ͕؊ w "module" : "bundler"ͷ߹"preserve"͔"esnext"͔͠બͳ͍
߹ʹΑͬͯඞཁͰ͖ͨΒ w "allowImportingTsExtensions"֦ுࢠΛলུͤͣ.tsͰJNQPSU w "allowArbitraryExtensions"ඇ+BWB4DSJQUϑΝΠϧΛJNQPSU͢Δ -
#SPXTFSΞϓϦέʔγϣϯίʔυͷઃఆྫ "compilerOptions": { // must "moduleResolution": "bundler", "module": "preserve", //
or `"esnext"` // optional / recommended "noEmit": true, // or `emitDeclarationOnly` "allowImportingTsExtensions": true, "allowArbitraryExtensions": true, "verbatimModuleSyntax": true } // package.json { type : "module" } -
/PEFΞϓϦέʔγϣϯίʔυͷઃఆ ඞਢ w "module" :"nodenext" "node16" / "node18" Λબ w
"moduleResolution"ˢͰࣗಈతʹܾఆ͞ΕΔͷͰུ Ͱ͖ͨΒ w "verbatimModuleSyntax"'VMM/BUJWF&4.ͳΒ -
/PEFKTΞϓϦέʔγϣϯίʔυͷઃఆྫ "compilerOptions": { // must "module": "nodenext", // recommended "verbatimModuleSyntax":
true, } // package.json { type : "module" } -
/PEFͷ54࣮ߦػೳΛ͍͍ͨ߹ +4ܕఆٛϑΝΠϧͷग़ྗΛ͍ͨ͠ w "rewriteRelativeImportExtensions" : true w ⚠ͨͩ͠ಈతͳJNQPSUTVCQBUIJNQPSU͑ͳ͍ +4ϑΝΠϧผʹग़ྗ͠ͳ͍ w
"allowImportingTsExtensions" : true"noEmit" : true ྆ํΛຬ͍ͨͨ͠߹ˠݱঢ়54 /PEFKTͰ͍͠😭 -
/PEFKTΞϓϦέʔγϣϯίʔυͷઃఆྫ "compilerOptions": { // must "module": "nodenext", // recommended "verbatimModuleSyntax":
true, // TS࣮ߦ͍ͨ͠ & jsͱܕఆٛϑΝΠϧు͖͍ͨ "rewriteRelativeImportExtensions": true } // package.json { type : "module" } -
/PEFKTΞϓϦέʔγϣϯίʔυͷઃఆྫ "compilerOptions": { // must "module": "nodenext", // recommended "verbatimModuleSyntax":
true, // js / .d.ts ు͔ͳ͍͍ͯ͘ਓ(TS࣮ߦ͚ͩ) "allowImportingTsExtensions": true "noEmit": true } // package.json { type : "module" } -
ϥΠϒϥϦͷ߹ ϥΠϒϥϦͷ·͍͠ͱ͜ΖͲͪΒͰղܾ͍͔ͨ͠ར༻͢Δଆ࣍ୈ w ཧతʹ͋ΒΏΔίϯύΠϧઃఆͰಈ͘͜ͱ͕ٻΊΒΕΔ બࢶ w &4.Ͱग़ྗ w ྆ํग़ྗ͢Δ ͍ΘΏΔ%VBM1BDLBHF
w ޙड़͢ΔͳͲ͋ΔͷͰຊฤͰհ͠ͳ͍ -
ิ %VBM1BDLBHFͷ ͍ΘΏΔ%VBM1BDLBHF)B[BSE w ಉ͡1BDLBHFͰ$+4&4.ͰҟͳΔϑΝΠϧΛJNQPSU͢Δ͜ͱ͕ݪҼ w ಛʹγϯάϧτϯͷΑ͏ͳΠϯελϯεͷঢ়ଶΛಡΈॻ͖͢Δ߹ w $+4ͱ&4.ͰΠϯελϯεڞ༗͞Εͳ͍ ผϑΝΠϧͳͷͰ
w ಉ͡ͷΛ৮͍ͬͯΔΑ͏ʹݟ͑ͯಉ͡ΠϯελϯεΛ৮͍ͬͯͳ͍ w ϓϥάΠϯܗࣜͰίϯςΩετΛҾ͖ܧ͙πʔϧͳͲͰʹͳΓ͕ͪ -
&4.͚ͩ͡ΌμϝͰ͔͢ʁ 1VSF&4.ύοέʔδ &4.͔͠ग़ྗ͍ͯ͠ͳ͍ Ͱग़͢༐ؾ w ݹ͍/PEF͡Όͳ͚Ε&4.αϙʔτͯ͠Δ w #VOEMFલఏͰϞμϯͳόϯυϥͬͯΔͳΒ&4.͚ͩͰ͍͍ w ΄Μͱʹ$+4Ͱಡ·ΕΔͷ͔ʁ
w ࣾར༻͚ͩͱ͔ͳΒಡΉଆΛͤͳ͍͜ͱ w require(ESM)ͷ͓͔͛Ͱ੍ݶ͋ΕͲޓੑ্ͨ͠ w 1VSF&4.ʹͳͬͨ༗໊ϥΠϒϥϦଟ͍ -
&4.ʹॻ͖ग़࣌͢ͷઃఆ ඞਢ w "module" : OPEFҎ্ͳΒ "nodenext" w "declaration"ܕఆٛϑΝΠϧͪΌΜͱग़ྗ Ͱ͖ͨΒ
w "verbatimModuleSyntax"UZQFJNQPSUΛڧ੍͢ΔͷͰɺՄೳͳΒ ΊΔ w "paths"5ZQF4DSJQUͷܕղܾͱSVOUJNFڍಈ͕มΘΔՄೳੑ -
/PEFKTϥΠϒϦίʔυͷઃఆྫ "compilerOptions": { // must "module": "nodenext", "declaration" : true
// recommended "verbatimModuleSyntax": true, } // package.json { type : "module" } -
&4.෩ 'BVY&4. Ͱॻ͍ͨࢿ࢈͕େ͖͍ํ ϥΠϒϥϦͷ߹PS/PEFͰಈ͘ΞϓϦͷ߹ w ૣΊͷ&4.ҠߦΛࢹʹೖΕ͍ͨ 0QJOJPO w Ͱͳ͍ͱ1VSF&4.ύοέʔδ͏ͷ&4.ͱͯ͠ॻ͖ग़͢ͷ໘
#VOEMF͢ΔΞϓϦίʔυͷ߹ w "moduleResolution": "bundler"͓͚ͯ͠Ұ୴ͦͷ··Ͱಈ͘ w ͱ͍͑༨༟͕͋ΔͷͰ͋ΕҠߦ͍͚ͨ͠Ͳ 0QJOJPO -
·ͱΊ w ݱঢ়$+4ͱ&4.͕ڞଘ͍ͯ͠Δ͕ɺϥϯλΠϜͰ྆ํαϙʔτ͞Ε͍ͯΔ w 54ͷ&4.αϙʔτ54͔ΒೖΓɺࠓͰ΄΅ͳ͑͘Δ w ҰํͰ$+4&4.ޓੑͳͲ͔ΒͲ͏ͯ͠0QUJPOෳࡶʹͳ͍ͬͯΔ w ·ͨ54͕&4.αϙʔτͯ͠ґવͱͯ͠Δ৽͍͠՝ w
ઃఆ͖͢ઃఆϥϯλΠϜґଘ͢Δͷɾར༻ܗଶʹΑͬͯมΘΔ w جຊతʹ&4.ʹҠߦͭͭ͠ɺΔ$+4ڥɾࢿ࢈ʹͲ͏ରԠ͢Δ͔ -
ࢀߟʹ͍͍ͤͯͨͩͨ͞هࣄɾϦιʔε w 5ZQF4DSJQU%PDVNFOUBUJPO.PEVMFT$IPPTJOH$PNQJMFS0QUJPOT w 5ZQF4DSJQU%PDVNFOUBUJPO.PEVMFT&4.$+4*OUFSPQFSBCJMJUZ w 5ZQF4DSJQU%PDVNFOUBUJPO.PEVMFT3FGFSFODF w 5ZQF4DSJQU%PDVNFOUBUJPO.PEVMFT5IFPSZ w
5ZQF4DSJQU%PDVNFOUBUJPO5ZQF4DSJQU w 5ZQF4DSJQU%PDVNFOUBUJPO5ZQF4DSJQU w BSFUIFUZQFTXSPOHBSFUIFUZQFTXSPOHHJUIVCJPu(JU)VC w 54ͷSFXSJUF3FMBUJWF*NQPSU&YUFOTJPOTΦϓγϣϯΛ͏લʹಡΉهࣄ w 5ZQF4DSJQUҎ߱Ͱ&4.ରԠͲ͏ͳΔͷ͔ʁ w 5ZQF4DSJQUͰՃ͞ΕͨWFSCBUJN.PEVMF4ZOUBYͱԿ͔ʁ -
ࢀߟʹ͍͍ͤͯͨͩͨ͞هࣄɾϦιʔε w 5ZQF4DSJQUº/PEFKTͰ&$."4DSJQU.PEVMFTΛࢼ͢$-07&3🍀 w 5ZQF4DSJQUͷNPEVMFΦϓγϣϯͷɺ͋Δ͍5ZQF4DSJQU։ൃऀͷۤɺ͋Δ͍$+4ͱ&4.ͷ w 5ZQF4DSJQU͕ͨΓલʯʹͳͬͨੈքʹ͓͍ͯɺ&4Ϟδϡʔϧຊདྷͷӡ༻ʹඞཁͳߟ͑ํͱઃఆͱ w /PEFKT 5ZQF4DSJQUͷϞδϡʔϧΛཧͯ͠ΈΔ
w /PEFKT/BUJWF&4.ͷಓʙ࠷ऴষ#BCFM5ZQF4DSJQU.PEVMFTͱͷಆ͍ʙc115 w ࣮ફ/PEFKT/BUJWF&4.8BOUFEMZͰͷΞϓϦέʔγϣϯҠߦࣄྫc8BOUFEMZ&OHJOFFS#MPH w SFRVJSF FTN JO/PEFKTc+PZFF$IFVOHT#MPH w .PWFPOUP&4.POMZ w %VBM1BDLBHF)B[BSEGSPNTDSBUDI -
%VBM1BDLBHFͰؤுΔ߹ ඇਪ جຊํ w QBDLBHFKTPOڞ௨ͳͷͰUZQFNPEVMFͰ&4.Ͱίʔυॻ͘ w &4.ɾ$+4༻ʹͦΕͧΕUTDPO fi HΛ࡞Δ w
ˠग़ྗઌΛ͚͓ͯ͘ w QBDLBHFKTPOͷ$POEJUJPOBMFYQPSUTػೳΛ͏ w %VBM1BDLBHFʹΑΔೝ͓ࣝͯ͘͠ ΛᛉΕΔ͜ͱΛ֬ೝ -
%VBM1BDLBHFͰؤுΔ߹ͷઃఆ // tsconfig.esm.json "compilerOptions": { "module": "nodenext", // or "node16"
/ "node18" // ... } // tsconfig.cjs.json "compilerOptions": { "module": "commojs", "esModuleInterop": true, // ... } -
%VBM1BDLBHFͰؤுΔ߹ QBDLBHFKTPODPOEJUJPOBMFYQPSUΛ͏ "exports": { ".": { "import": "./esm/lib.js", // for
ESM "require": "./cjs/lib.js" // for CJS } }, -
%VBM1BDLBHFͰؤுΔ߹ 54͔ΒFYQPSTͷUZQFTEFGBVMUϑΟʔϧυղऍ͢ΔΑ͏ʹͳͬͨ "exports": { ".": { "import": { // for
ESM "types": "./types/esm/index.d.ts", // types "default": "./esm/index.js" // js }, "require": {...} } } -
%VBM1BDLBHFͰؤுΔ߹ Ճ͑ͯݹ͍/PEF54ͷͨΊʹ'BMMCBDLࢦఆ͓ͯ͘͠ͱྑ͍ { // Fall-back for older versions of TypeScript
"types": "./types/index.d.ts", // CJS fall-back for older versions of Node.js "main": "./commonjs/index.cjs" }