Skip to content

docs(📚): say what the background hold costs and how to stop producing - #611

Merged
wcandillon merged 1 commit into
mainfrom
docs-background-work
Nov 5, 2026
Merged

wcandillon merged 1 commit into
mainfrom
docs-background-work

Conversation

@wcandillon

Copy link
Copy Markdown
Owner

Docs only. Makes the iOS and tvOS "Background and foreground" section more useful for the behavior that ships today.

  • A held onSubmittedWorkDone() or mapAsync() promise settles only once the app is back, so background code awaiting one waits until then. This replaces "Nothing changes for your code".
  • Leads with the memory cost of submitting in the background rather than battery, and adds an AppState render loop example.
  • Says what opting out does: the device is lost over the first refused command buffer (also in gpu-device-extensions).

Not covered: whether held work can get a backgrounded app killed, which has not been measured on a device.

Not run: the docs build.

A held promise settles only once the app is back, what is submitted in the
background stays in memory and then runs all at once, and turning the toggle
off loses the device. Show a render loop that stops submitting.
@wcandillon
wcandillon merged commit 4bdc3b1 into main Nov 5, 2026
4 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant