Pewarta Proxy

📋 Server Request & Proxy Logs

Loading active proxy settings...
Developed by Khairul Adha (adhexa.id)
Mengambil log server...

⚙️ Pengaturan Proxy Target

Skip to content

fix: stop twelve wrapped calls from holding the app unstable - #3827

Open
armando-navarro wants to merge 1 commit into
angular:mainfrom
armando-navarro:a60-blocking-callbacks
Open

armando-navarro wants to merge 1 commit into
angular:mainfrom
armando-navarro:a60-blocking-callbacks

Conversation

@armando-navarro

Copy link
Copy Markdown
Collaborator

Fixes #3826

  • Adds blockUntilFirst: false entries to tools/build.ts for eleven callback-taking calls whose first callback a normal load may never run.
  • Moves the isSupported entry zone log verbosity #3613 meant for firebase/remote-config into the block that exports it.
  • Regenerates the five affected files.

Checklist

Changes

The mechanism:

The eleven calls whose first callback is not guaranteed, now { blockUntilFirst: false, logLevel: LogLevel.WARN }:

  • onLog: never stable until some Firebase SDK logs. It returns void, so no unsubscribe can release the task either.
  • onTokenChanged: never stable until a token is obtained, which a first visit with no auto refresh and no protected request never asks for.
  • onChildAdded: never stable on an empty node. A new listener's initial events are only child_added, one per existing child, and value.
  • onChildChanged, onChildMoved, onChildRemoved: never stable until someone changes, moves or removes a child. None fires on attach.
  • off(query, eventType, callback): never stable. It never calls the callback it is given and returns void.
  • enableLogging(fn): never stable until the database SDK logs something.
  • fromRef on a child event, stateChanges and auditTrail (rxfire, default events): never stable on an empty node, since they emit only on child events.
  • Keeping logLevel: LogLevel.WARN means only the pending task changes: callbacks are still re-entered into the zone and the injection context, and a call outside an injection context still prints its per-function line at the warning level.

isSupported in @angular/fire/remote-config, now { blockUntilFirst: false }:

  • With true, every call in a browser with IndexedDB held a pending task until the indexedDB.open it awaits answered, and for good in a browser that never answers.
  • zone log verbosity #3613 added isSupported: { blockUntilFirst: false } for it, matching the analytics and messaging entries, but in the rxfire/remote-config block, which exports no isSupported. Overrides match by name, so it did nothing.
  • build: classify the firebase symbols a version raise would newly wrap #3759 added the check that fails the build on such an entry, deleted this one and deferred the move.

What callers can notice

  • A server render no longer waits for the first batch of onChildAdded children, so the server HTML of a list filled that way can ship before they arrive (reasoned from the wrapper, not run).
  • onValue, object and list deliver a value on attach, empty node or not, and still hold the render.
  • off(ref, eventType, callback) no longer holds the app, but it still detaches nothing, because the wrapper replaces the callback with its own closure before the SDK compares callback identities.
  • The unsubscribe returned by onValue and onChild* is the supported way to detach.
  • Code that awaits ApplicationRef.whenStable() before chained Remote Config work no longer waits for isSupported.
  • Inside isSupported's .then, inject() throws and the zone is the one that attached the .then, at both flag values, so the callback sees no difference.
  • isSupported outside an injection context now logs its per-call line only at the verbose level, as the analytics and messaging copies do.

Verification

  • Measured in Chrome on a zone.js Angular 22 app and a zoneless one, against the Database and Firestore emulators.
  • Each run recorded every ApplicationRef.isStable emission and counted PendingTasks.add calls.
  • At true, the never-firing cases above registered a task that was never released.
  • At true, onChildAdded on a populated node, onValue, onSnapshotsInSync and onTokenChanged with auto refresh on released theirs within 2 to 23 ms, and onChildChanged released as soon as a child was written.
  • At false, no task was registered in any run, and inside every callback that ran inject() worked and, under zone.js, NgZone.isInAngularZone() was true.
  • A fresh Angular 22 SSR app with onLog in provideAppInitializer: ng build fails at the route extractor's 30-second timeout with Routes extraction was aborted when onLog comes from @angular/fire/app, and builds in about 2 s from firebase/app.
  • isSupported at true holds the app unstable until the IndexedDB check answers, tens of milliseconds in Chrome, and for the whole window when indexedDB.open is stubbed to never fire. At false it registers no task.
  • Specs: 15 new in src/app/app.spec.ts, src/app-check/app-check.spec.ts and src/database/database.spec.ts, and 1 in src/remote-config/remote-config.spec.ts. Each asserts the call registers no pending task.
  • The app, app-check and database spec files each have a positive control proving the spy sees the wrapper's registrations.
  • Dropping onLog, onChildChanged, fromRef or isSupported from tools/build.ts and rebuilding fails the matching spec.
  • npm run build regenerates with the unrecognized-override check passing, and npm run test:node, npm run test:chrome-headless and npm run lint pass.

ɵzoneWrap holds a pending task from the moment a wrapped call gets a
callback until that callback first runs. For onLog, onTokenChanged,
the Database child listeners (onChildAdded on an empty node, the other
three until a later change), off, enableLogging, and the rxfire
streams fromRef, stateChanges and auditTrail, nothing guarantees that
first run, so ApplicationRef.isStable can stay false for good and an
SSR build's route extraction times out, as angular#3748 reported for
beforeAuthStateChanged. The eleven keep logLevel WARN, so only the
pending task changes.

isSupported in remote-config is the twelfth: angular#3613 put its
blockUntilFirst: false entry in the rxfire block, which exports no
isSupported, so it never applied, and angular#3759 removed the dead entry.

Server renders no longer wait for onChildAdded's first batch (onValue,
object and list still wait), and off(ref, type, cb) still detaches
nothing, because the wrapper replaces the callback it is given.

Fixes angular#3826
@armando-navarro armando-navarro added backport: 21.1.x Cherry-pick onto the 21.1.x branch for a 21.1 minor release bump: patch Size of the change: a fix or docs change that reaches users comp: app-check App Check (src/app-check). comp: build/pipeline Build, bundling, packaging, release pipeline. comp: core FirebaseApp DI core (src/app). comp: database Realtime Database (src/database). comp: remote-config Remote Config (src/remote-config). comp: ssr Server-side rendering, hydration, @angular/ssr interop. comp: zones Change detection / zone.js / zoneless. type: bug Defect: expected behavior doesn't happen. labels Oct 29, 2026

@tyler-reitz tyler-reitz left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One blocking point: the fromRef override applies to every event, not only the child events the body describes.

In rxfire, object(query) is fromRef(query, ListenEvent.value), so after this change object(ref) still holds the render but the documented fromRef(ref, 'value') doesn't. A probe spec on this branch shows it: fromRef(ref(database, rando()), ListenEvent.value) registers 0 pending tasks, while object(ref(database, rando())) registers 1. On main, fromRef is generated with true, so I'd expect it to register one there (read from the generated file, not run).

Overrides match by name, so I don't think tools/build.ts can narrow this, and the tradeoff may well be right, since a child-event fromRef can hang forever. Either way, please add it to "What callers can notice" and to the docs follow-up, plus a spec pinning the 'value' case so the behavior is deliberate rather than incidental.

Non-blocking: two stray blank lines in the database override block in tools/build.ts, after enableLogging and after onChildRemoved.

Everything else checked out: a fresh build regenerates the five files byte-identical to the PR, and Chrome headless passes 132/132 locally.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport: 21.1.x Cherry-pick onto the 21.1.x branch for a 21.1 minor release bump: patch Size of the change: a fix or docs change that reaches users comp: app-check App Check (src/app-check). comp: build/pipeline Build, bundling, packaging, release pipeline. comp: core FirebaseApp DI core (src/app). comp: database Realtime Database (src/database). comp: remote-config Remote Config (src/remote-config). comp: ssr Server-side rendering, hydration, @angular/ssr interop. comp: zones Change detection / zone.js / zoneless. type: bug Defect: expected behavior doesn't happen.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Eleven wrapped callbacks and remote-config isSupported hold the app unstable until something that may never happen

2 participants