FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

docs: Add error boundaries entries by JeanMeche · Pull Request #70560 · angular/angular · GitHub

docs: Add error boundaries entries - #70560

Merged
atscott merged 1 commit into
angular:mainfrom
JeanMeche:error-boundary-docs
Sep 10, 2026
Merged

atscott merged 1 commit into
angular:mainfrom
JeanMeche:error-boundary-docs

Conversation

JeanMeche commented Sep 3, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

No description provided.

angular-robot Bot added the area: docs Related to the documentation label Sep 3, 2026
ngbot Bot added this to the Backlog milestone Sep 3, 2026
Error handling isn't limited to template syntax. If you are creating components or embedded views dynamically using `ViewContainerRef` or the standalone `createComponent` function, you can provide an `onError` callback in the options object. This callback functions identically to an `@error` block but for imperatively created views.

```ts
viewContainerRef.createComponent(DynamicComponent, {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

I think we can also avoid the "Component" suffix here

Suggested change
viewContainerRef.createComponent(DynamicComponent, {
viewContainerRef.createComponent(Dynamic, {

atscott left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

AGENT: Thank you for putting together the documentation for @boundary!

Overall, the content is well-structured and provides a clear overview of error boundaries in Angular templates. I have left inline suggestions focused on alignment with the Angular Documentation Style Guide and Google Technical Writing guidelines (sentence case in headings, present tense instead of future "will", active voice, avoiding Latin abbreviations and casual idioms).

Key highlights:

  • tools/manual_api_docs/blocks/boundary.md: Note that $retry was updated to $reset in the compiler/runtime primitives. I have flagged this inline so the syntax matches the actual compiler implementation.
  • Section deduplication: The "Dynamic views and programmatic error handling" section is currently duplicated in full between error-boundaries.md and programmatic-rendering.md. Consider linking from error-boundaries.md to programmatic-rendering.md#handling-rendering-errors to maintain a single source of truth.
  • Commit message headline: Minor note for whenever rebasing/squashing: per the commit message guidelines, headline summaries should not be capitalized (docs: add error boundaries entries).

JeanMeche added action: merge The PR is ready for merge by the caretaker target: minor This PR is targeted for the next minor release labels Sep 10, 2026
atscott merged commit e205075 into angular:main Sep 10, 2026
24 of 27 checks passed

atscott commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

This PR was merged into the repository. The changes were merged into the following branches:

This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action: merge The PR is ready for merge by the caretaker adev: preview area: docs Related to the documentation target: minor This PR is targeted for the next minor release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants


Back | FazBrowse Home | New Git URL