API › @builder.io/qwik/server
getQwikLoaderScript
以字串形式提供 qwikloader.js
檔案。適用於將 qwikloader 腳本內嵌到 HTML 的工具。
export declare function getQwikLoaderScript(opts?: { debug?: boolean }): string;
參數
類型
說明
opts
{ debug?: boolean; }
(可選)
字串
getQwikPrefetchWorkerScript
以字串形式提供 qwik-prefetch-service-worker.js
檔案。適用於將 qwik-prefetch-service-worker 腳本內嵌到 HTML 的工具。
export declare function getQwikPrefetchWorkerScript(opts?: {
debug?: boolean;
}): string;
參數
類型
說明
opts
{ debug?: boolean; }
(可選)
字串
InOrderAuto
export interface InOrderAuto
屬性
修飾字
類型
說明
數字
(可選)
數字
(可選)
「自動」
InOrderDisabled
export interface InOrderDisabled
屬性
修飾字
類型
說明
「已停用」
InOrderStreaming
export type InOrderStreaming = InOrderAuto | InOrderDisabled | InOrderDirect;
參考: InOrderAuto、InOrderDisabled
PrefetchImplementation
export interface PrefetchImplementation
屬性
修飾字
類型
說明
「js-append」|「html-append」| null
(可選) js-append
:使用 JS 執行階段建立每個 <link>
並附加到主體。
html-append
:在 html 中渲染每個 <link>
,附加在主體的末尾。
「prefetch」|「preload」|「modulepreload」| null
(可選) 使用連結時 <link rel="...">
屬性的值。如果插入連結,則預設為 prefetch
。
「總是」| null
(可選) 發送一個 qprefetch
事件,其中包含應預先擷取的組合的詳細資料。事件發送腳本將會內嵌到文件的 HTML 中,因此此事件的任何監聽器都應該已準備好處理事件。
此實作將會插入類似於以下內容的腳本
<script type="module">
document.dispatchEvent(new CustomEvent("qprefetch", { detail:{ "bundles": [...] } }))
</script>
預設情況下,prefetchEvent
實作將會設定為 always
。
「總是」|「no-link-support」| null
(可選) 總是
:始終包含 worker fetch JS 執行階段。
no-link-support
:僅在瀏覽器不支援 <link>
prefetch/preload/modulepreload 時才包含 worker fetch JS 執行階段。
PrefetchResource
export interface PrefetchResource
屬性
修飾字
類型
說明
字串
PrefetchStrategy
export interface PrefetchStrategy
屬性
修飾字
類型
說明
(可選)
(可選)
QwikLoaderOptions
export interface QwikLoaderOptions
屬性
修飾字
類型
說明
'always' | 'never' | 'auto'
(可選)
'top' | 'bottom'
(可選)
Render
export type Render = RenderToString | RenderToStream;
參考: RenderToString, RenderToStream
RenderOptions
export interface RenderOptions extends SerializeDocumentOptions
屬性
修飾字
類型
說明
string | ((options: RenderOptions) => string)
(選填) 指定客戶端構建的 JS 文件的根目錄。設置 base 將導致在 q:container
元素中呈現 q:base
屬性。
Record<string, string>
(可選)
字串
(選填) 設定後,應用程式會被序列化為片段。並且返回的 html 不是完整的文檔。默認為 html
string | ((options: RenderOptions) => string)
(選填) 呈現文檔時使用的語言。
PrefetchStrategy | null
(可選)
(選填) 指定是否將 Qwik Loader 腳本添加到文檔中。
默認為 { include: true }
。
QwikPrefetchServiceWorkerOptions
(選填) 指定是否將 Qwik Prefetch Service Worker 腳本添加到文檔中。
默認為 { include: false }
。注意:這在未來可能會有所改變。
Record<string, any>
(可選)
boolean
(選填) 默認為 true
RenderResult
export interface RenderResult
屬性
修飾字
類型
說明
boolean
QwikManifest
(可選)
SnapshotResult | undefined
renderToStream
export type RenderToStream = (
opts: RenderToStreamOptions,
) => Promise<RenderToStreamResult>;
參考: RenderToStreamOptions, RenderToStreamResult
RenderToStream
export type RenderToStream = (
opts: RenderToStreamOptions,
) => Promise<RenderToStreamResult>;
參考: RenderToStreamOptions, RenderToStreamResult
RenderToStreamOptions
export interface RenderToStreamOptions extends RenderOptions
擴展: RenderOptions
屬性
修飾字
類型
說明
StreamWriter
(可選)
RenderToStreamResult
export interface RenderToStreamResult extends RenderResult
擴展: RenderResult
屬性
修飾字
類型
說明
數字
數字
{ firstFlush: number; render: number; snapshot: number; }
renderToString
export type RenderToString = (
opts: RenderToStringOptions,
) => Promise<RenderToStringResult>;
參考: RenderToStringOptions, RenderToStringResult
RenderToString
export type RenderToString = (
opts: RenderToStringOptions,
) => Promise<RenderToStringResult>;
參考: RenderToStringOptions, RenderToStringResult
RenderToStringOptions
export interface RenderToStringOptions extends RenderOptions
擴展: RenderOptions
RenderToStringResult
export interface RenderToStringResult extends RenderResult
擴展: RenderResult
屬性
修飾字
類型
說明
字串
{ render: number; snapshot: number; }
resolveManifest
export declare function resolveManifest(
manifest: QwikManifest | ResolvedManifest | undefined,
): ResolvedManifest | undefined;
參數
類型
說明
manifest
QwikManifest | ResolvedManifest | undefined
ResolvedManifest | undefined
SerializeDocumentOptions
export interface SerializeDocumentOptions
屬性
修飾字
類型
說明
boolean
(可選)
QwikManifest | ResolvedManifest
(可選)
SymbolMapperFn
(可選)
setServerPlatform
export declare function setServerPlatform(
manifest: QwikManifest | ResolvedManifest | undefined,
): Promise<void>;
參數
類型
說明
manifest
QwikManifest | ResolvedManifest | undefined
Promise<void>
StreamingOptions
export interface StreamingOptions
屬性
修飾字
類型
說明
(可選)
SymbolsToPrefetch
自動:預取文檔使用的所有可能的 QRL。默認
export type SymbolsToPrefetch =
| "auto"
| ((opts: { manifest: QwikManifest }) => PrefetchResource[]);
參考: PrefetchResource
版本
versions: {
readonly qwik: string;
readonly qwikDom: string;
}