跳到主要內容

logging

選項

抓取

您可以在開發模式下執行 Next.js 時,設定記錄層級以及是否將完整 URL 記錄到主控台。

目前,logging 僅適用於使用 fetch API 進行的資料抓取。它尚不適用於 Next.js 內部的其他記錄。

next.config.js
module.exports = {
  logging: {
    fetches: {
      fullUrl: true,
    },
  },
}

預設情況下,從伺服器元件 HMR 快取還原的任何 fetch 請求都不會被記錄。但是,可以通過將 logging.fetches.hmrRefreshes 設定為 true 來啟用此功能。

next.config.js
module.exports = {
  logging: {
    fetches: {
      hmrRefreshes: true,
    },
  },
}

連入請求

預設情況下,所有連入請求都會在開發期間記錄在主控台中。您可以使用 incomingRequests 選項來決定要忽略哪些請求。由於這僅在開發期間記錄,因此此選項不會影響生產版本。

next.config.js
module.exports = {
  logging: {
    incomingRequests: {
      ignore: [/\api\/v1\/health/],
    },
  },
}

或者,您可以通過將 incomingRequests 設定為 false 來停用連入請求記錄。

next.config.js
module.exports = {
  logging: {
    incomingRequests: false,
  },
}

停用記錄

此外,您可以通過將 logging 設定為 false 來停用開發記錄。

next.config.js
module.exports = {
  logging: false,
}