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

オープン

#741 2026年7月17日に作成コメント 1 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 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時間
マージ済み PR（30日）: 10

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
issue 番号を参照したプルリクエストを送ります。

FirebaseExtended/reactfire のほかの issue

No bindings for Firebase AI Logic オープン

難易度 5/5 1週間以上初心者へのやさしさ 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 1週間以上初心者へのやさしさ 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 をもっと見る