組態

是否使用雜湊或隨機數來限制 <script> 和 <style> 元素。'auto' 會對預先渲染的頁面使用雜湊，而對動態渲染的頁面使用隨機數。

將會新增到 Content-Security-Policy 標頭的指令。

將會新增到 Content-Security-Policy-Report-Only 標頭的指令。

是否檢查 POST、PUT、PATCH 或 DELETE 表單提交的輸入 origin 標頭，並驗證它是否與伺服器的來源相符。

若要允許人們從其他來源對您的應用程式進行 POST、PUT、PATCH 或 DELETE 請求，其 Content-Type 為 application/x-www-form-urlencoded、multipart/form-data 或 text/plain，您需要停用此選項。請小心！

搜尋 .env 檔案的目錄。

表示環境變數可以安全公開給用戶端程式碼的前綴。請參閱 $env/static/public 和 $env/dynamic/public。請注意，如果您使用 Vite 的環境變數處理，則必須另外設定 Vite 的 envPrefix，但通常不需要使用該功能。

表示環境變數不安全公開給用戶端程式碼的前綴。與公開或私人前綴都不相符的環境變數將會完全捨棄。請參閱 $env/static/private 和 $env/dynamic/private。

放置應該有穩定網址且不經過任何處理的靜態檔案，例如 favicon.ico 或 manifest.json

應用程式的內部程式庫，可以在整個程式碼庫中以 $lib 存取

包含 參數比對器 的目錄

定義應用程式結構的檔案（請參閱 路由）

服務工作執行緒進入點的位置（請參閱 服務工作執行緒）

HTML 回應範本的位置

備用錯誤回應範本的位置

SvelteKit 將預載初始頁面所需的 JavaScript 模組，以避免匯入「瀑布」，從而加快應用程式的啟動速度。有三個策略具有不同的權衡

• modulepreload - 使用 <link rel="modulepreload">。這在基於 Chromium 的瀏覽器、Firefox 115+ 和 Safari 17+ 中提供最佳結果。它在較舊的瀏覽器中會被忽略。
• preload-js - 使用 <link rel="preload">。防止在 Chromium 和 Safari 中出現瀑布，但 Chromium 會將每個模組解析兩次（一次作為指令碼，一次作為模組）。導致在 Firefox 中請求模組兩次。如果您希望以犧牲 Chromium 使用者輕微降級為代價，最大化 iOS 裝置使用者的效能，這是一個不錯的設定。
• preload-mjs - 使用 <link rel="preload"> 但搭配 .mjs 副檔名，這可以防止在 Chromium 中重複解析。有些靜態 Web 伺服器無法以 Content-Type: application/javascript 標頭提供 .mjs 檔案，這將導致應用程式中斷。如果這不適用於您，這是在 modulepreload 更廣泛地受到支援之前，能為最多數使用者提供最佳效能的選項。

應用程式檔案提供服務的絕對路徑。如果您的檔案從某種儲存空間提供服務，這會很有用。

根目錄相對路徑，必須以 / 開頭，但不能以 / 結尾（例如 /base-path），除非它是空字串。這會指定應用程式提供服務的位置，並允許應用程式存在於非根目錄路徑上。請注意，您需要在所有根目錄相對連結前面加上基本值，否則它們將指向網域的根目錄，而不是您的 base（這是瀏覽器的工作方式）。您可以使用 $app/paths 中的 base：<a href="{base}/your-page">Link</a>。如果您發現自己經常撰寫這個，將其萃取成可重複使用的元件可能是合理的。

是否使用相對的資產路徑。

如果為 true，在伺服器端渲染期間，從 $app/paths 匯入的 base 和 assets 將會被替換為相對的資產路徑，產生更具可攜性的 HTML。如果為 false，%sveltekit.assets% 和對建置成品的參照將永遠是根目錄相對路徑，除非 paths.assets 是外部 URL

單頁式應用程式 回退頁面將永遠使用絕對路徑，不論此設定為何。

如果您的應用程式使用 <base> 元素，您應該將此設定為 false，否則資產 URL 將會不正確地根據 <base> URL 解析，而不是目前的頁面。

在 1.0 中，undefined 是有效的數值，預設會設定。在這種情況下，如果 paths.assets 不是外部的，SvelteKit 會將 %sveltekit.assets% 替換成相對路徑，並使用相對路徑參照建置成品，但從 $app/paths 匯入的 base 和 assets 會如您的設定中所指定。

可以同時預先呈現多少個頁面。JS 是單執行緒的，但在預先呈現效能受限於網路的情況下（例如從遠端 CMS 載入內容），這可以在等待網路回應時處理其他工作，以加快速度。

SvelteKit 是否應透過追蹤從 entries 的連結來尋找要預先呈現的頁面。

要預先呈現或從中開始爬取的頁面陣列（如果 crawl: true）。* 字串包含所有不包含必要 [parameters] 的路由，並將包含的選用參數視為空白（因為 SvelteKit 不知道任何參數應具有的值）。

預先呈現應用程式時遇到 HTTP 錯誤的回應方式。

• 'fail' — 讓建置失敗
• 'ignore' - 靜默忽略失敗並繼續
• 'warn' — 繼續，但印出警告
• (details) => void — 自訂錯誤處理常式，它會接收一個 details 物件，其中包含 status、path、referrer、referenceType 和 message 屬性。如果從這個函式 throw，建置將會失敗

ts
/** @type {import('@sveltejs/kit').Config} */
const config = {
	kit: {
		prerender: {
			handleHttpError: ({ path, referrer, message }) => {
				// ignore deliberate link to shiny 404 page
				if (path === '/not-found' && referrer === '/blog/how-we-built-our-404-page') {
					return;
				}

				// otherwise fail the build
				throw new Error(message);
			}
		}
	}
};

從一個預先呈現的頁面到另一個預先呈現的頁面的雜湊連結與目標頁面上的 id 不相符時的回應方式。

• 'fail' — 讓建置失敗
• 'ignore' - 靜默忽略失敗並繼續
• 'warn' — 繼續，但印出警告
• (details) => void — 自訂錯誤處理常式，它會接收一個 details 物件，其中包含 path、id、referrers 和 message 屬性。如果從這個函式 throw，建置將會失敗

entries 匯出所產生的項目與其所產生的路由不符時的回應方式。

• 'fail' — 讓建置失敗
• 'ignore' - 靜默忽略失敗並繼續
• 'warn' — 繼續，但印出警告
• (details) => void — 自訂錯誤處理常式，它會接收一個 details 物件，其中包含 generatedFromId、entry、matchedId 和 message 屬性。如果從這個函式 throw，建置將會失敗

預先呈現期間 url.origin 的值；如果包含在已呈現的內容中，這會很有用。

如果服務工作者存在，是否自動註冊它。

決定 static 目錄中的哪些檔案會在 $service-worker.files 中可用。

一個允許你編輯產生的 tsconfig.json 的函式。你可以變異組態（推薦）或回傳一個新的。這在擴充一個單一儲存庫根目錄中的共用 tsconfig.json 時很有用，例如。

目前的應用程式版本字串。如果指定，這必須是確定的（例如提交參考，而不是 Math.random() 或 Date.now().toString()），否則預設為建置的時間戳記。

例如，要使用目前的提交雜湊，你可以使用 git rev-parse HEAD

ts
import * as child_process from 'node:child_process';

export default {
	kit: {
		version: {
			name: child_process.execSync('git rev-parse HEAD').toString().trim()
		}
	}
};

輪詢版本變更的間隔（毫秒）。如果這為 0，則不會進行輪詢。