首頁·報錯訊息

node · JavaScript

報錯原文

ReferenceError: require is not defined in ES module scope, you can use import instead

這是什麼意思

這正是上一條錯誤的鏡像——檔案被當作 ESM 讀,裡面卻有 CommonJS 的 require。它幾乎總是發生在剛給 package.json 加上 "type": "module"、而舊指令碼還留在目錄裡的時候。想讓那一個檔案留在舊世界,mv script.js script.cjs 是最小的改動;想把它遷過去,把 require 改成 import 的同時還得處理 __dirname 和 require.main === module,這兩個在 ESM 裡並不存在。

怎麼修

mv script.js script.cjs
來自
node
JavaScript
15

瀏覽器和 node 的錯誤通常只告訴你什麼壞了,不告訴你那個值為什麼變成這樣——你讀了 undefined、它不是函式、它不是 JSON——所以該修的地方在拋錯那一行的上游;只用 ?. 和預設值把那一行按住,同樣的問題會在更遠的地方、以更難辨認的樣子回來。

怎麼讀報錯

  • 從第一行往下讀。越往下越是工具內部的事,起因通常寫在最上面。
  • 有檔名和行號就從那裡查——不是堆疊最上面那一格,而是最上面那條提到你自己寫的檔案的行。
  • 把報錯原文照樣去搜,但先去掉你自己的路徑和變數名,正是那些讓搜尋比對不上。
  • 同一種情況在不同版本裡措辭不同。結果不對頭,就把版本號一起加進查詢。
  • 貼上修法之前,先確認它會丟掉什麼。這裡面有些是不能收回的。

常見問題

Q. “ReferenceError: require is not defined in ES module scope, you can use import instead” 是什麼意思?

這正是上一條錯誤的鏡像——檔案被當作 ESM 讀,裡面卻有 CommonJS 的 require。它幾乎總是發生在剛給 package.json 加上 "type": "module"、而舊指令碼還留在目錄裡的時候。想讓那一個檔案留在舊世界,mv script.js script.cjs 是最小的改動;想把它遷過去,把 require 改成 import 的同時還得處理 __dirname 和 require.main === module,這兩個在 ESM 裡並不存在。

Q. 怎麼修?

mv script.js script.cjs —— 執行前先看上面的說明,確認這條命令會丟掉什麼。

Q. 這是哪個工具報的?

node。它屬於JavaScript,報錯原文有 14 個詞。

相關報錯