 深入解析)
开发工具后端【免费下载链接】firebase-js-sdkFirebase Javascript SDK项目地址https://gitcode.com/gh_mirrors/fi/firebase-js-sdk点击查看免费下载本文基于 firebase-js-sdk 仓库关联 API 参考文档讲解firebase/remote-configWeb SDK 实时更新机制中的核心类型ConfigUpdate。当你使用onConfigUpdate订阅远程配置的实时变更时SDK 会向你的回调函数传入一个ConfigUpdate实例通过它的getUpdatedKeys()方法你可以精确得知本次更新中哪些配置参数 key 发生了变化。读完本文你将掌握ConfigUpdate的类型签名、判定已更新的完整规则、与ConfigUpdateObserver/onConfigUpdate的协作方式以及其底层实现在仓库源码中的对应位置。ConfigUpdate 接口概览ConfigUpdate是 firebase-js-sdk 在firebase/remote-config包中公开的一个 TypeScript 接口用于描述一次远程配置实时更新中发生了变化的参数 key 集合。它的官方定义如下摘自 docs-devsite/remote-config.configupdate.mdexport interface ConfigUpdate接口的语义是一句话Contains information about which keys have been updated包含关于哪些 key 已被更新的信息。在源码中该接口定义于 packages/remote-config/src/public_types.ts/** * Contains information about which keys have been updated. * * public */ export interface ConfigUpdate { /** * Parameter keys whose values have been updated from the currently activated values. * Includes keys that are added, deleted, or whose value, value source, or metadata has changed. */ getUpdatedKeys(): Setstring; }可以看到ConfigUpdate是一个方法型接口它不暴露任何公开属性只暴露一个getUpdatedKeys()方法。这种设计刻意隐藏了 SDK 内部如何存储变更信息的实现细节只向开发者提供统一的读取入口。getUpdatedKeys() 方法详解方法签名与返回值原文档给出的签名如下getUpdatedKeys(): Setstring;返回值类型Setstring——一个字符串集合集合中的每个字符串对应一个发生了变化的 Remote Config 参数 key。典型使用方式遍历该集合对变化的 key 执行差异化处理或者用has(key)判断某个特定参数是否发生了变化。已更新的判定标准原文档对getUpdatedKeys()返回内容有明确界定返回的是与当前已激活配置相比值发生变化的参数 key具体包含以下四类情况新增的 keyadded本次拉取的新模板中出现了但当前激活配置中不存在的参数。删除的 keydeleted当前激活配置中存在但本次新模板中已被移除的参数。值发生变化的 key同一个 key 在旧模板与新模板中的 value 不同。值来源value source或元数据metadata发生变化的 key例如参数被绑定到 A/B 实验experiment或灰度发布rollout其来源或关联元数据发生变化也会被判定为已更新。这一判定逻辑在源码中由RealtimeHandler.getChangedParams()实现位于 packages/remote-config/src/client/realtime_handler.ts我们将在下文源码级原理一节详细拆解。如何获取 ConfigUpdateonConfigUpdate 与 ConfigUpdateObserverConfigUpdate对象不是凭空产生的它通过onConfigUpdate(remoteConfig, observer)API 订阅实时更新流后由 SDK 在检测到更新时传入你的 observer 回调。这是 Firebase Remote Config Web SDK 的实时Realtime更新能力的入口对应 remote-config.md 参考文档 中的函数签名export declare function onConfigUpdate(remoteConfig: RemoteConfig, observer: ConfigUpdateObserver): Unsubscribe;其语义包括开始监听 Remote Config 后端的实时配置更新并在有更新可用时自动从后端拉取最新配置如果与后端之间尚未建立连接首次调用会建立连接多次调用可注册多个监听器但后续调用会复用同一条已建立的连接返回一个Unsubscribe函数类型为() void用于移除该监听器。onConfigUpdate接收的observer参数类型是ConfigUpdateObserver定义见 packages/remote-config/src/public_types.ts对应 ConfigUpdateObserver 参考文档它包含三个可选回调属性类型说明next(configUpdate: ConfigUpdate) void当新的ConfigUpdate可用时被调用error(error: FirebaseError) void当流发生错误时被调用complete() void当流被优雅终止时被调用注意ConfigUpdateObserver的complete回调虽然允许提供但永远不会被调用因为ConfigUpdate流是永不结束的never-ending——这是原文档和源码注释中反复强调的一点见 packages/remote-config/src/public_types.ts。onConfigUpdate在 packages/remote-config/src/api.ts 中的实现非常简洁——它只是一个薄封装把 observer 注册到内部RealtimeHandler上export function onConfigUpdate( remoteConfig: RemoteConfig, observer: ConfigUpdateObserver ): Unsubscribe { const rc getModularInstance(remoteConfig) as RemoteConfigImpl; rc._realtimeHandler.addObserver(observer); return () { rc._realtimeHandler.removeObserver(observer); }; }完整使用示例结合上面的类型关系一个典型的实时监听代码如下基于firebase/remote-config公开 APIimport { getRemoteConfig, onConfigUpdate } from firebase/remote-config; const remoteConfig getRemoteConfig(); // 注册实时更新监听器 const unsubscribe onConfigUpdate( remoteConfig, { async next(configUpdate) { // 1. 先拿到本次更新的 key 集合 const updatedKeys configUpdate.getUpdatedKeys(); // 2. 判断你关心的参数是否发生变化 if (updatedKeys.has(welcome_message)) { const newMessage remoteConfig.getString(welcome_message); // 在这里更新 UI 或业务逻辑 updateBanner(newMessage); } // 3. 或者遍历所有变化的 key 做批量处理 updatedKeys.forEach(key { console.log(Remote Config key ${key} has been updated.); }); }, error(error) { // 流式连接出错时的处理 console.error(Realtime stream error:, error); } // 注意不要依赖 complete 回调ConfigUpdate 流是永续的 // complete 永远不会被调用源码注释明确说明这一点。 } ); // 页面卸载或不再需要监听时调用 unsubscribe 移除监听 // unsubscribe();使用要点getUpdatedKeys()返回的集合可以直接用于has()判断或forEach遍历拿到ConfigUpdate后SDK 已经完成了自动拉取此时再用getString(key)/getNumber(key)/getBoolean(key)等 getter 读取得到的就是新值每个onConfigUpdate调用返回一个独立的Unsubscribe函数用于移除对应的 observer。源码级原理getChangedParams 如何计算更新 key 集合ConfigUpdate.getUpdatedKeys()返回的数据来源于RealtimeHandler在自动拉取最新配置后对新旧模板执行差异对比的结果。核心方法是getChangedParams()packages/remote-config/src/client/realtime_handler.ts其算法可概括为三个步骤1. 新旧 key 集合做差集const newKeys new Set(Object.keys(newConfig || {})); const oldKeys new Set(Object.keys(oldConfig || {})); for (const key of newKeys) { if (!oldKeys.has(key) || newConfig[key] ! oldConfig[key]) { changedKeys.add(key); // 新增 key或值发生变化的 key continue; } ... } for (const key of oldKeys) { if (!newKeys.has(key)) { changedKeys.add(key); // 被删除的 key } }遍历newKeys如果某个 key 不在旧集合中新增或者新旧值不相等值变化立即加入changedKeys遍历oldKeys如果某个 key 不在新集合中被删除同样加入changedKeys。2. 实验Experiments与灰度发布Rollouts的元数据对比当 key 同时存在于新旧配置且值相同时还会继续检查它是否与 A/B 实验或 rollout 的关联发生变化通过createExperimentsMap()realtime_handler.ts将实验描述按affectedParameterKeys建立key - experiment映射跳过以_exp_rollout前缀开头的实验 id通过createRolloutsMap()realtime_handler.ts将 rollout 元数据按受影响的参数 key 建立映射如果newExperimentsMap.has(key) ! oldExperimentsMap.has(key)或两个实验描述不相等areExperimentsEqual比较experimentId、variantId、timeToLiveMillis、triggerTimeoutMillis四个字段或两个 rollout 映射不相等areRolloutsEqual比较每个 rolloutId 对应的 variantId则该 key 也会被判定为已更新。这正对应了原文档中value source 或 metadata 已变化的判定条款也解释了 CHANGELOG 中Support realtime for Remote Config rollouts、Support ABT realtime when variant value matches default value of parameter等演进见 packages/remote-config/CHANGELOG.md。3. 封装为 ConfigUpdate 并派发计算完updatedKeys后fetchLatestConfig()realtime_handler.ts会构造ConfigUpdate对象并通知所有 observerconst configUpdate: ConfigUpdate { getUpdatedKeys(): Setstring { return new Set(updatedKeys); // 每次调用都返回一个 Set 副本 } }; this.executeAllListenerCallbacks(configUpdate);有两个值得注意的实现细节getUpdatedKeys()每次调用都会返回new Set(updatedKeys)即返回一个副本调用方可以安全地遍历或修改返回的集合而不会污染 SDK 内部状态如果拉取结果中没有任何参数变化updatedKeys.size 0SDK 会记录 Config was fetched, but no params changed. 的 debug 日志并直接返回不通知 observerrealtime_handler.ts。连接管理与自动拉取的完整链路ConfigUpdate的产生离不开底层的实时流机制。RealtimeHandlerpackages/remote-config/src/client/realtime_handler.ts负责建立连接createRealtimeConnection()L239-L253通过 Firebase Installations 获取安装 ID 与令牌向实时端点发起 POST 流式请求请求头携带X-Goog-Api-Key、X-Goog-Firebase-Installations-Auth请求体包含project、namespace、lastKnownVersionNumber、appId、sdkVersion、appInstanceId见establishRealtimeConnection()L193-L228。监听通知handleNotifications()L565-L652使用ReadableStream读取分块编码的响应体重组可能被切分的 JSON 消息解析latestTemplateVersionNumber、featureDisabled、retryIntervalSeconds等字段当latestTemplateVersionNumber大于当前版本时触发autoFetch()。自动拉取与对比fetchLatestConfig()使用MAXIMUM_FETCH_ATTEMPTS 3次重试拉取最新模板fetchType 为REALTIME若版本仍不够新则随机延迟 0~3 秒后重试拉取成功后调用上文提到的getChangedParams()生成ConfigUpdate并派发给所有 observerL460-L534。后台/前台切换应用进入后台时关闭连接以节省资源回到前台时自动重连onVisibilityChangeL839-L846。退避重试连接失败时按指数退避基准 60 秒、倍率 2见updateBackoffMetadataWithLastFailedStreamConnectionTimeL100-L113持久化退避元数据并对 408/429/502/503/504 等可重试状态码自动重连L135-L144。错误处理observer.error 会收到哪些错误当实时流出现问题ConfigUpdateObserver.error会收到一个FirebaseError。可预见的错误码定义在 packages/remote-config/src/errors.ts其中与实时更新直接相关的有四个错误码触发场景错误描述见 errors.tsstream-errorCONFIG_UPDATE_STREAM_ERROR无法连接到实时后端或 HTTP 状态码不可重试realtime-unavailableCONFIG_UPDATE_UNAVAILABLE后端在消息中下发featureDisabled: true服务暂时不可用update-message-invalidCONFIG_UPDATE_MESSAGE_INVALID流中下发的失效消息无法解析update-not-fetchedCONFIG_UPDATE_NOT_FETCHED自动拉取最新配置失败或重试次数用尽源码通过ERROR_FACTORY.create(ErrorCode.XXX, { originalErrorMessage })构造这些错误例如 realtime_handler.ts、L600-L608、L643-L647、L760-L766error.code形如remoteconfig/stream-error。另外据 CHANGELOG 记载SDK 已修复应用进入后台时误报CONFIG_UPDATE_STREAM_ERROR的问题——后台关闭连接不再计为失败也不会累计退避惩罚。测试验证getUpdatedKeys 的行为保证仓库中的测试用例对ConfigUpdate与onConfigUpdate的行为给出了明确验证packages/remote-config/test/api.test.ts 验证了onConfigUpdate会调用内部realtimeHandler.addObserver、返回一个Unsubscribe函数、该函数会调用removeObserver并且当实时处理器派发更新时observer 收到的对象包含getUpdatedKeys函数其返回值与派发时的Set一致测试中模拟返回new Set([new_key])。packages/remote-config/test/client/realtime_handler.test.ts 中大量断言configUpdate.getUpdatedKeys()的结果覆盖了新增 key如new Set([newKey])、多个 key 同时变化如new Set([keyA, keyC])、删除 key 等场景见 L470、L571、L649、L724、L846 等处的断言。小结ConfigUpdate是 Firebase Remote Config Web SDK 实时更新能力的变更通知载体通过getUpdatedKeys(): Setstring暴露发生变化的参数 key判定已更新覆盖新增、删除、值变化、值来源/元数据变化四类情况实现于 realtime_handler.ts 的getChangedParams()通过onConfigUpdateConfigUpdateObserver订阅其中next回调接收ConfigUpdateerror回调接收FirebaseErrorcomplete永远不会触发getUpdatedKeys()每次返回 Set 副本调用方可以放心遍历当无任何参数变化时SDK 不会触发通知相关类型定义、实现与测试均位于 packages/remote-config 目录下API 全貌可查阅 remote-config.md接口细节见 configupdate 参考文档 与 configupdateobserver 参考文档。赞分享开发工具后端【免费下载链接】firebase-js-sdkFirebase Javascript SDK项目地址https://gitcode.com/gh_mirrors/fi/firebase-js-sdk点击查看免费下载相关推荐Parakeet-TDT-0.6B-V2如何做到1.69%超低词错率语音识别Parakeet TDT 0.6B V2如何做到1.69%超低词错率语音识别 导语 NVIDIA最新发布的Parakeet TDT 0.6B V2语音识别开发工具后端React Native Firebase Remote Config 完整实战指南动态配置、实时更新与模块源码解析React Native Firebase Remote Config 完整实战指南动态配置、实时更新与模块源码解析 Remote Config 是 Fire移动开发后端Firebase JS SDK Remote Config 完整 API 指南从参数读取到实时更新Firebase JS SDK Remote Config 完整 API 指南从参数读取到实时更新 本篇技术指南以 Firebase JS SDK 官方 AP开发工具后端上一篇使用 Mermaid Timeline 图绘制科研时间线scientific-agent-skills 中 markdown-mermaid-writing 技能实战指南下一篇SeaTunnel ClickhouseFile Sink 连接器详解基于 clickhouse-local 的海量数据批量文件导入创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
开发工具后端【免费下载链接】firebase-js-sdkFirebase Javascript SDK项目地址https://gitcode.com/gh_mirrors/fi/firebase-js-sdk点击查看免费下载本文基于 firebase-js-sdk 仓库关联 API 参考文档讲解firebase/remote-configWeb SDK 实时更新机制中的核心类型ConfigUpdate。当你使用onConfigUpdate订阅远程配置的实时变更时SDK 会向你的回调函数传入一个ConfigUpdate实例通过它的getUpdatedKeys()方法你可以精确得知本次更新中哪些配置参数 key 发生了变化。读完本文你将掌握ConfigUpdate的类型签名、判定已更新的完整规则、与ConfigUpdateObserver/onConfigUpdate的协作方式以及其底层实现在仓库源码中的对应位置。ConfigUpdate 接口概览ConfigUpdate是 firebase-js-sdk 在firebase/remote-config包中公开的一个 TypeScript 接口用于描述一次远程配置实时更新中发生了变化的参数 key 集合。它的官方定义如下摘自 docs-devsite/remote-config.configupdate.mdexport interface ConfigUpdate接口的语义是一句话Contains information about which keys have been updated包含关于哪些 key 已被更新的信息。在源码中该接口定义于 packages/remote-config/src/public_types.ts/** * Contains information about which keys have been updated. * * public */ export interface ConfigUpdate { /** * Parameter keys whose values have been updated from the currently activated values. * Includes keys that are added, deleted, or whose value, value source, or metadata has changed. */ getUpdatedKeys(): Setstring; }可以看到ConfigUpdate是一个方法型接口它不暴露任何公开属性只暴露一个getUpdatedKeys()方法。这种设计刻意隐藏了 SDK 内部如何存储变更信息的实现细节只向开发者提供统一的读取入口。getUpdatedKeys() 方法详解方法签名与返回值原文档给出的签名如下getUpdatedKeys(): Setstring;返回值类型Setstring——一个字符串集合集合中的每个字符串对应一个发生了变化的 Remote Config 参数 key。典型使用方式遍历该集合对变化的 key 执行差异化处理或者用has(key)判断某个特定参数是否发生了变化。已更新的判定标准原文档对getUpdatedKeys()返回内容有明确界定返回的是与当前已激活配置相比值发生变化的参数 key具体包含以下四类情况新增的 keyadded本次拉取的新模板中出现了但当前激活配置中不存在的参数。删除的 keydeleted当前激活配置中存在但本次新模板中已被移除的参数。值发生变化的 key同一个 key 在旧模板与新模板中的 value 不同。值来源value source或元数据metadata发生变化的 key例如参数被绑定到 A/B 实验experiment或灰度发布rollout其来源或关联元数据发生变化也会被判定为已更新。这一判定逻辑在源码中由RealtimeHandler.getChangedParams()实现位于 packages/remote-config/src/client/realtime_handler.ts我们将在下文源码级原理一节详细拆解。如何获取 ConfigUpdateonConfigUpdate 与 ConfigUpdateObserverConfigUpdate对象不是凭空产生的它通过onConfigUpdate(remoteConfig, observer)API 订阅实时更新流后由 SDK 在检测到更新时传入你的 observer 回调。这是 Firebase Remote Config Web SDK 的实时Realtime更新能力的入口对应 remote-config.md 参考文档 中的函数签名export declare function onConfigUpdate(remoteConfig: RemoteConfig, observer: ConfigUpdateObserver): Unsubscribe;其语义包括开始监听 Remote Config 后端的实时配置更新并在有更新可用时自动从后端拉取最新配置如果与后端之间尚未建立连接首次调用会建立连接多次调用可注册多个监听器但后续调用会复用同一条已建立的连接返回一个Unsubscribe函数类型为() void用于移除该监听器。onConfigUpdate接收的observer参数类型是ConfigUpdateObserver定义见 packages/remote-config/src/public_types.ts对应 ConfigUpdateObserver 参考文档它包含三个可选回调属性类型说明next(configUpdate: ConfigUpdate) void当新的ConfigUpdate可用时被调用error(error: FirebaseError) void当流发生错误时被调用complete() void当流被优雅终止时被调用注意ConfigUpdateObserver的complete回调虽然允许提供但永远不会被调用因为ConfigUpdate流是永不结束的never-ending——这是原文档和源码注释中反复强调的一点见 packages/remote-config/src/public_types.ts。onConfigUpdate在 packages/remote-config/src/api.ts 中的实现非常简洁——它只是一个薄封装把 observer 注册到内部RealtimeHandler上export function onConfigUpdate( remoteConfig: RemoteConfig, observer: ConfigUpdateObserver ): Unsubscribe { const rc getModularInstance(remoteConfig) as RemoteConfigImpl; rc._realtimeHandler.addObserver(observer); return () { rc._realtimeHandler.removeObserver(observer); }; }完整使用示例结合上面的类型关系一个典型的实时监听代码如下基于firebase/remote-config公开 APIimport { getRemoteConfig, onConfigUpdate } from firebase/remote-config; const remoteConfig getRemoteConfig(); // 注册实时更新监听器 const unsubscribe onConfigUpdate( remoteConfig, { async next(configUpdate) { // 1. 先拿到本次更新的 key 集合 const updatedKeys configUpdate.getUpdatedKeys(); // 2. 判断你关心的参数是否发生变化 if (updatedKeys.has(welcome_message)) { const newMessage remoteConfig.getString(welcome_message); // 在这里更新 UI 或业务逻辑 updateBanner(newMessage); } // 3. 或者遍历所有变化的 key 做批量处理 updatedKeys.forEach(key { console.log(Remote Config key ${key} has been updated.); }); }, error(error) { // 流式连接出错时的处理 console.error(Realtime stream error:, error); } // 注意不要依赖 complete 回调ConfigUpdate 流是永续的 // complete 永远不会被调用源码注释明确说明这一点。 } ); // 页面卸载或不再需要监听时调用 unsubscribe 移除监听 // unsubscribe();使用要点getUpdatedKeys()返回的集合可以直接用于has()判断或forEach遍历拿到ConfigUpdate后SDK 已经完成了自动拉取此时再用getString(key)/getNumber(key)/getBoolean(key)等 getter 读取得到的就是新值每个onConfigUpdate调用返回一个独立的Unsubscribe函数用于移除对应的 observer。源码级原理getChangedParams 如何计算更新 key 集合ConfigUpdate.getUpdatedKeys()返回的数据来源于RealtimeHandler在自动拉取最新配置后对新旧模板执行差异对比的结果。核心方法是getChangedParams()packages/remote-config/src/client/realtime_handler.ts其算法可概括为三个步骤1. 新旧 key 集合做差集const newKeys new Set(Object.keys(newConfig || {})); const oldKeys new Set(Object.keys(oldConfig || {})); for (const key of newKeys) { if (!oldKeys.has(key) || newConfig[key] ! oldConfig[key]) { changedKeys.add(key); // 新增 key或值发生变化的 key continue; } ... } for (const key of oldKeys) { if (!newKeys.has(key)) { changedKeys.add(key); // 被删除的 key } }遍历newKeys如果某个 key 不在旧集合中新增或者新旧值不相等值变化立即加入changedKeys遍历oldKeys如果某个 key 不在新集合中被删除同样加入changedKeys。2. 实验Experiments与灰度发布Rollouts的元数据对比当 key 同时存在于新旧配置且值相同时还会继续检查它是否与 A/B 实验或 rollout 的关联发生变化通过createExperimentsMap()realtime_handler.ts将实验描述按affectedParameterKeys建立key - experiment映射跳过以_exp_rollout前缀开头的实验 id通过createRolloutsMap()realtime_handler.ts将 rollout 元数据按受影响的参数 key 建立映射如果newExperimentsMap.has(key) ! oldExperimentsMap.has(key)或两个实验描述不相等areExperimentsEqual比较experimentId、variantId、timeToLiveMillis、triggerTimeoutMillis四个字段或两个 rollout 映射不相等areRolloutsEqual比较每个 rolloutId 对应的 variantId则该 key 也会被判定为已更新。这正对应了原文档中value source 或 metadata 已变化的判定条款也解释了 CHANGELOG 中Support realtime for Remote Config rollouts、Support ABT realtime when variant value matches default value of parameter等演进见 packages/remote-config/CHANGELOG.md。3. 封装为 ConfigUpdate 并派发计算完updatedKeys后fetchLatestConfig()realtime_handler.ts会构造ConfigUpdate对象并通知所有 observerconst configUpdate: ConfigUpdate { getUpdatedKeys(): Setstring { return new Set(updatedKeys); // 每次调用都返回一个 Set 副本 } }; this.executeAllListenerCallbacks(configUpdate);有两个值得注意的实现细节getUpdatedKeys()每次调用都会返回new Set(updatedKeys)即返回一个副本调用方可以安全地遍历或修改返回的集合而不会污染 SDK 内部状态如果拉取结果中没有任何参数变化updatedKeys.size 0SDK 会记录 Config was fetched, but no params changed. 的 debug 日志并直接返回不通知 observerrealtime_handler.ts。连接管理与自动拉取的完整链路ConfigUpdate的产生离不开底层的实时流机制。RealtimeHandlerpackages/remote-config/src/client/realtime_handler.ts负责建立连接createRealtimeConnection()L239-L253通过 Firebase Installations 获取安装 ID 与令牌向实时端点发起 POST 流式请求请求头携带X-Goog-Api-Key、X-Goog-Firebase-Installations-Auth请求体包含project、namespace、lastKnownVersionNumber、appId、sdkVersion、appInstanceId见establishRealtimeConnection()L193-L228。监听通知handleNotifications()L565-L652使用ReadableStream读取分块编码的响应体重组可能被切分的 JSON 消息解析latestTemplateVersionNumber、featureDisabled、retryIntervalSeconds等字段当latestTemplateVersionNumber大于当前版本时触发autoFetch()。自动拉取与对比fetchLatestConfig()使用MAXIMUM_FETCH_ATTEMPTS 3次重试拉取最新模板fetchType 为REALTIME若版本仍不够新则随机延迟 0~3 秒后重试拉取成功后调用上文提到的getChangedParams()生成ConfigUpdate并派发给所有 observerL460-L534。后台/前台切换应用进入后台时关闭连接以节省资源回到前台时自动重连onVisibilityChangeL839-L846。退避重试连接失败时按指数退避基准 60 秒、倍率 2见updateBackoffMetadataWithLastFailedStreamConnectionTimeL100-L113持久化退避元数据并对 408/429/502/503/504 等可重试状态码自动重连L135-L144。错误处理observer.error 会收到哪些错误当实时流出现问题ConfigUpdateObserver.error会收到一个FirebaseError。可预见的错误码定义在 packages/remote-config/src/errors.ts其中与实时更新直接相关的有四个错误码触发场景错误描述见 errors.tsstream-errorCONFIG_UPDATE_STREAM_ERROR无法连接到实时后端或 HTTP 状态码不可重试realtime-unavailableCONFIG_UPDATE_UNAVAILABLE后端在消息中下发featureDisabled: true服务暂时不可用update-message-invalidCONFIG_UPDATE_MESSAGE_INVALID流中下发的失效消息无法解析update-not-fetchedCONFIG_UPDATE_NOT_FETCHED自动拉取最新配置失败或重试次数用尽源码通过ERROR_FACTORY.create(ErrorCode.XXX, { originalErrorMessage })构造这些错误例如 realtime_handler.ts、L600-L608、L643-L647、L760-L766error.code形如remoteconfig/stream-error。另外据 CHANGELOG 记载SDK 已修复应用进入后台时误报CONFIG_UPDATE_STREAM_ERROR的问题——后台关闭连接不再计为失败也不会累计退避惩罚。测试验证getUpdatedKeys 的行为保证仓库中的测试用例对ConfigUpdate与onConfigUpdate的行为给出了明确验证packages/remote-config/test/api.test.ts 验证了onConfigUpdate会调用内部realtimeHandler.addObserver、返回一个Unsubscribe函数、该函数会调用removeObserver并且当实时处理器派发更新时observer 收到的对象包含getUpdatedKeys函数其返回值与派发时的Set一致测试中模拟返回new Set([new_key])。packages/remote-config/test/client/realtime_handler.test.ts 中大量断言configUpdate.getUpdatedKeys()的结果覆盖了新增 key如new Set([newKey])、多个 key 同时变化如new Set([keyA, keyC])、删除 key 等场景见 L470、L571、L649、L724、L846 等处的断言。小结ConfigUpdate是 Firebase Remote Config Web SDK 实时更新能力的变更通知载体通过getUpdatedKeys(): Setstring暴露发生变化的参数 key判定已更新覆盖新增、删除、值变化、值来源/元数据变化四类情况实现于 realtime_handler.ts 的getChangedParams()通过onConfigUpdateConfigUpdateObserver订阅其中next回调接收ConfigUpdateerror回调接收FirebaseErrorcomplete永远不会触发getUpdatedKeys()每次返回 Set 副本调用方可以放心遍历当无任何参数变化时SDK 不会触发通知相关类型定义、实现与测试均位于 packages/remote-config 目录下API 全貌可查阅 remote-config.md接口细节见 configupdate 参考文档 与 configupdateobserver 参考文档。赞分享开发工具后端【免费下载链接】firebase-js-sdkFirebase Javascript SDK项目地址https://gitcode.com/gh_mirrors/fi/firebase-js-sdk点击查看免费下载相关推荐Parakeet-TDT-0.6B-V2如何做到1.69%超低词错率语音识别Parakeet TDT 0.6B V2如何做到1.69%超低词错率语音识别 导语 NVIDIA最新发布的Parakeet TDT 0.6B V2语音识别开发工具后端React Native Firebase Remote Config 完整实战指南动态配置、实时更新与模块源码解析React Native Firebase Remote Config 完整实战指南动态配置、实时更新与模块源码解析 Remote Config 是 Fire移动开发后端Firebase JS SDK Remote Config 完整 API 指南从参数读取到实时更新Firebase JS SDK Remote Config 完整 API 指南从参数读取到实时更新 本篇技术指南以 Firebase JS SDK 官方 AP开发工具后端上一篇使用 Mermaid Timeline 图绘制科研时间线scientific-agent-skills 中 markdown-mermaid-writing 技能实战指南下一篇SeaTunnel ClickhouseFile Sink 连接器详解基于 clickhouse-local 的海量数据批量文件导入创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
