types: initialData in ReactFireOptions<T> should accept snapshot types for snapshot hooks

未关闭

#741 创建于 2026年7月17日 1 条评论 0 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 3/5
预计耗时: 1-2 天
新手友好度: 52/100

Issue 类型: 缺陷
描述清晰度: 基本清楚
活跃度: 冷清
技术栈: firebase, react, typescript
领域: frontend

调研方向

首先定位 ReactFireOptions 以及快照钩子 useFirestoreDoc、useFirestoreDocOnce 和 useFirestoreCollection。查看 #740 中跟踪的已知限制，然后将这些类型与数据钩子进行比较。完成的标准是：快照钩子接受其 DocumentSnapshot 或 QuerySnapshot initialData 类型，而数据钩子仍保留 T，且不进行任何运行时更改。

由索引模型根据 Issue 内容生成。

描述

Summary

ReactFireOptions<T> types initialData as T, which is correct for the data hooks (useFirestoreDocData, useFirestoreCollectionData, useDatabaseObjectData, etc.). For the raw snapshot hooks, the correct type is the snapshot wrapper, not the unwrapped data type:

Hook	Correct `initialData` type
`useFirestoreDoc`	`DocumentSnapshot<T>`
`useFirestoreDocOnce`	`DocumentSnapshot<T>`
`useFirestoreCollection`	`QuerySnapshot<T>`

Corrected: this table originally listed a fourth row, useFirestoreCollectionOnce. No such export exists. The raw snapshot hooks are the three above.

This mismatch is pre-existing and was silently masked by the T | any widening removed in #740. It is not a regression from that PR.

Options

Split ReactFireOptions into separate types for data hooks vs snapshot hooks, each with the correct initialData type.
Make initialData generic at the hook level (e.g., initialData?: TSnapshot) independent of the data type T.

Either approach would be a TypeScript-only change with no runtime impact.

Tracked in #740 (known limitation section).

主要语言: TypeScript
星标: 3.6k
派生: 403
平均合并: 5 天 1 小时
30 天内合并 PR: 10

贡献指南

打开贡献指南

从这里开始

先读完整个 Issue，再读项目的贡献指南。
在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
Fork 仓库，在一个分支上完成修改。
提交 Pull Request，并在描述里引用这个 Issue 编号。

FirebaseExtended/reactfire 的其他 Issue

No bindings for Firebase AI Logic 未关闭

难度 5/5 一周以上新手友好度 38/100

FirebaseExtended/reactfire#801 · 2026年8月25日创建
Suspense mode resumes with the previous observable's value on React 19 未关闭

v5

难度 4/5 3-5 天新手友好度 48/100

FirebaseExtended/reactfire#793 · 2026年8月12日创建
The observable cache leaks subscriptions and is shared across SSR requests 未关闭

v5

难度 4/5 3-5 天新手友好度 35/100

FirebaseExtended/reactfire#790 · 2 条评论 · 2026年8月11日创建
React 19 foundation: run tests against 19, then drop React 16/17 未关闭

v5

难度 4/5 3-5 天新手友好度 55/100

FirebaseExtended/reactfire#789 · 2026年8月11日创建
Tests that keep passing when the code they cover is broken 未关闭

难度 5/5 一周以上新手友好度 35/100

FirebaseExtended/reactfire#788 · 2026年8月10日创建

查看 FirebaseExtended/reactfire 的全部 Issue

相似的 Issue

Tapping "Use video" more than once submits the verification twice 未关闭

难度 2/5 1-3 小时新手友好度 84/100

bcgov/bc-wallet-mobile#4761 · 1 条评论 · 2026年9月24日创建
fix(pg-meta): schemas.update and schemas.remove DO blocks fail when a name contains "$$" 未关闭

external-issue to-triage

难度 2/5 1-3 小时新手友好度 88/100

supabase/supabase#50882 · 2026年9月24日创建
Azure Sandboxes: Small and ExtraSmall tiers always fail to deploy (disk request exceeds tier maximum) 未关闭

area-deployment area-integrations triage:bot-seen

难度 2/5 半天新手友好度 86/100

microsoft/aspire#20459 · 1 条评论 · 2026年9月24日创建
Mobile builds drop the telemetry and crash-reporting keys, so opting in sends nothing 未关闭

难度 2/5 1-3 小时新手友好度 82/100

0xMiden/wallet#1118 · 2026年9月24日创建
[P3] Handle clipboard failures and announce copy status accessibly 未关闭

refactor

难度 2/5 1-3 小时新手友好度 84/100

nteract/semiotic#1534 · 2026年9月24日创建

更多 TypeScript Issue