output.assetsRetry
- 类型：
Object
output.assetsRetry 用于配置资源加载失败时的重试逻辑。配置类型如下:
export type AssetsRetryHookContext = {
times: number;
domain: string;
url: string;
tagName: string;
};
export type AssetsRetryOptions = {
type?: string[];
domain?: string[];
max?: number;
test?: string | ((url: string) => boolean);
crossOrigin?: boolean | 'anonymous' | 'use-credentials';
inlineScript?: boolean;
onRetry?: (options: AssetsRetryHookContext) => void;
onSuccess?: (options: AssetsRetryHookContext) => void;
onFail?: (options: AssetsRetryHookContext) => void;
};- 默认值：
undefined
由于该能力会往 HTML 中和 webpack/Rspack Runtime 注入额外的一些运行时代码，因此我们默认关闭了该能力，如果需要开启该能力，你可以添加以下配置：
export default {
output: {
assetsRetry: {},
},
};当你开启该能力后，assetsRetry 的默认配置如下：
export const defaultAssetsRetryOptions: AssetsRetryOptions = {
type: ['script', 'link', 'img'],
domain: [],
max: 3,
test: '',
crossOrigin: false,
inlineScript: false,
onRetry: () => {},
onSuccess: () => {},
onFail: () => {},
};示例
你可以通过 assetsRetry 配置项，来定制你的重试逻辑。
如，通过 assetsRetry.domain 指定资源加载失败时的重试域名列表，第一个域名应该与 assetsPrefix 配置中的域名保持一致：
export default {
output: {
assetsRetry: {
domain: ['cdn1.com', 'cdn2.com', 'cdn3.com'],
},
assetsPrefix: 'https://cdn1.com', // 或 '//cdn1.com'
},
};添加以上配置后，当 cdn1.com 域名的资源加载失败时，请求域名会自动降级到 cdn2.com。
如果 cdn2.com 的资源也请求失败，则会继续请求 cdn3.com。
assetsRetry 是基于 Rsbuild 的 Assets Retry 插件实现的，并提供相同的配置项。你可以参考 Rsbuild - Assets Retry 插件 来了解所有可用的配置项。