UNPKG

@rxap/ngx-error

Version:

This package provides a comprehensive error handling solution for Angular applications, including interceptors, services, and UI components to display different types of errors in a user-friendly dialog. It supports handling of generic errors, HTTP errors

776 lines (649 loc) 28.6 kB
<!doctype html> <html class="no-js" lang=""> <head> <meta charset="utf-8"> <meta http-equiv="x-ua-compatible" content="ie=edge"> <title>angular-error</title> <meta name="description" content=""> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="icon" type="image/x-icon" href="../images/favicon.ico"> <link rel="stylesheet" href="../styles/style.css"> <link rel="stylesheet" href="../styles/dark.css"> </head> <body> <script> // Blocking script to avoid flickering dark mode // Dark mode toggle button var useDark = window.matchMedia('(prefers-color-scheme: dark)'); var darkModeState = useDark.matches; var $darkModeToggleSwitchers = document.querySelectorAll('.dark-mode-switch input'); var $darkModeToggles = document.querySelectorAll('.dark-mode-switch'); var darkModeStateLocal = localStorage.getItem('compodoc_darkmode-state'); function checkToggle(check) { for (var i = 0; i < $darkModeToggleSwitchers.length; i++) { $darkModeToggleSwitchers[i].checked = check; } } function toggleDarkMode(state) { if (window.localStorage) { localStorage.setItem('compodoc_darkmode-state', state); } checkToggle(state); const hasClass = document.body.classList.contains('dark'); if (state) { for (var i = 0; i < $darkModeToggles.length; i++) { $darkModeToggles[i].classList.add('dark'); } if (!hasClass) { document.body.classList.add('dark'); } } else { for (var i = 0; i < $darkModeToggles.length; i++) { $darkModeToggles[i].classList.remove('dark'); } if (hasClass) { document.body.classList.remove('dark'); } } } useDark.addEventListener('change', function (evt) { toggleDarkMode(evt.matches); }); if (darkModeStateLocal) { darkModeState = darkModeStateLocal === 'true'; } toggleDarkMode(darkModeState); </script> <div class="navbar navbar-default navbar-fixed-top d-md-none p-0"> <div class="d-flex"> <a href="../" class="navbar-brand">angular-error</a> <button type="button" class="btn btn-default btn-menu ion-ios-menu" id="btn-menu"></button> </div> </div> <div class="xs-menu menu" id="mobile-menu"> <div id="book-search-input" role="search"><input type="text" placeholder="Type to search"></div> <compodoc-menu></compodoc-menu> </div> <div class="container-fluid main"> <div class="row main"> <div class="d-none d-md-block menu"> <compodoc-menu mode="normal"></compodoc-menu> </div> <!-- START CONTENT --> <div class="content component"> <div class="content-data"> <ol class="breadcrumb"> <li class="breadcrumb-item">Components</li> <li class="breadcrumb-item" > ErrorDialogComponent</li> </ol> <ul class="nav nav-tabs" role="tablist"> <li class="nav-item"> <a href="#info" class="nav-link active" role="tab" id="info-tab" data-bs-toggle="tab" data-link="info">Info</a> </li> <li class="nav-item"> <a href="#source" class="nav-link" role="tab" id="source-tab" data-bs-toggle="tab" data-link="source">Source</a> </li> <li class="nav-item"> <a href="#templateData" class="nav-link" role="tab" id="templateData-tab" data-bs-toggle="tab" data-link="template">Template</a> </li> <li class="nav-item"> <a href="#styleData" class="nav-link" role="tab" id="styleData-tab" data-bs-toggle="tab" data-link="style">Styles</a> </li> <li class="nav-item"> <a href="#tree" class="nav-link" role="tab" id="tree-tab" data-bs-toggle="tab" data-link="dom-tree">DOM Tree</a> </li> </ul> <div class="tab-content"> <div class="tab-pane fade active in" id="info"><p class="comment"> <h3>File</h3> </p> <p class="comment"> <code>src/lib/error-dialog/error-dialog.component.ts</code> </p> <p class="comment"> <h3>Implements</h3> </p> <p class="comment"> <code>AfterViewInit</code> </p> <section data-compodoc="block-metadata"> <h3>Metadata</h3> <table class="table table-sm table-hover metadata"> <tbody> <tr> <td class="col-md-3">changeDetection</td> <td class="col-md-9"><code>ChangeDetectionStrategy.Default</code></td> </tr> <tr> <td class="col-md-3">selector</td> <td class="col-md-9"><code>rxap-error-dialog</code></td> </tr> <tr> <td class="col-md-3">imports</td> <td class="col-md-9"> <code>NgIf</code> <code>NgClass</code> <code>NgForOf</code> <code>PortalModule</code> </td> </tr> <tr> <td class="col-md-3">styleUrls</td> <td class="col-md-9"><code>./error-dialog.component.scss</code></td> </tr> <tr> <td class="col-md-3">templateUrl</td> <td class="col-md-9"><code>./error-dialog.component.html</code></td> </tr> </tbody> </table> </section> <section data-compodoc="block-index"> <h3 id="index">Index</h3> <table class="table table-sm table-bordered index-table"> <tbody> <tr> <td class="col-md-4"> <h6><b>Properties</b></h6> </td> </tr> <tr> <td class="col-md-4"> <ul class="index-list"> <li> <span class="modifier">Public</span> <span class="modifier">Readonly</span> <a href="#activeIndex" >activeIndex</a> </li> <li> <span class="modifier">Public</span> <span class="modifier">Readonly</span> <a href="#componentPortal" >componentPortal</a> </li> <li> <span class="modifier">Public</span> <span class="modifier">Readonly</span> <a href="#data" >data</a> </li> <li> <span class="modifier"></span> <span class="modifier">Public</span> <a href="#dialog" >dialog</a> </li> <li> <span class="modifier">Public</span> <span class="modifier">Readonly</span> <a href="#displayedButtons" >displayedButtons</a> </li> </ul> </td> </tr> <tr> <td class="col-md-4"> <h6><b>Methods</b></h6> </td> </tr> <tr> <td class="col-md-4"> <ul class="index-list"> <li> <a href="#close" >close</a> </li> </ul> </td> </tr> <tr> <td class="col-md-4"> <h6><b>Outputs</b></h6> </td> </tr> <tr> <td class="col-md-4"> <ul class="index-list"> <li> <a href="#closeDialog" >closeDialog</a> </li> </ul> </td> </tr> </tbody> </table> </section> <section data-compodoc="block-outputs"> <h3 id="outputs">Outputs</h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="closeDialog"></a> <b>closeDialog</b> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>EventEmitter</code> </td> </tr> <tr> <td class="col-md-2" colspan="2"> <div class="io-line">Defined in <a href="" data-line="61" class="link-to-prism">src/lib/error-dialog/error-dialog.component.ts:61</a></div> </td> </tr> </tbody> </table> </section> <section data-compodoc="block-methods"> <h3 id="methods"> Methods </h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="close"></a> <span class="name"> <span ><b>close</b></span> <a href="#close"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>close()</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="83" class="link-to-prism">src/lib/error-dialog/error-dialog.component.ts:83</a></div> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Returns : </b> <code><a href="https://www.typescriptlang.org/docs/handbook/basic-types.html" target="_blank" >void</a></code> </div> </td> </tr> </tbody> </table> </section> <section data-compodoc="block-properties"> <h3 id="inputs"> Properties </h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="activeIndex"></a> <span class="name"> <span class="modifier">Public</span> <span class="modifier">Readonly</span> <span ><b>activeIndex</b></span> <a href="#activeIndex"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>signal(0)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="54" class="link-to-prism">src/lib/error-dialog/error-dialog.component.ts:54</a></div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="componentPortal"></a> <span class="name"> <span class="modifier">Public</span> <span class="modifier">Readonly</span> <span ><b>componentPortal</b></span> <a href="#componentPortal"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>computed(() &#x3D;&gt; { const index &#x3D; this.activeIndex(); const data &#x3D; this.data(); const injector &#x3D; Injector.create({ parent: this.injector, providers: [ { provide: RXAP_ERROR_DIALOG_ERROR, useValue: data[index], }, ], }); return new ComponentPortal(this.component, null, injector); })</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="64" class="link-to-prism">src/lib/error-dialog/error-dialog.component.ts:64</a></div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="data"></a> <span class="name"> <span class="modifier">Public</span> <span class="modifier">Readonly</span> <span ><b>data</b></span> <a href="#data"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>Signal&lt;any[]&gt;</code> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>inject(RXAP_ERROR_DIALOG_DATA)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="52" class="link-to-prism">src/lib/error-dialog/error-dialog.component.ts:52</a></div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="dialog"></a> <span class="name"> <span class="modifier"></span> <span class="modifier">Public</span> <span ><b>dialog</b></span> <a href="#dialog"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <i>Type : </i> <code>ElementRef&lt;HTMLDialogElement&gt;</code> </td> </tr> <tr> <td class="col-md-4"> <b>Decorators : </b> <br /> <code> @ViewChild(&#x27;dialog&#x27;, {static: true})<br /> </code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="50" class="link-to-prism">src/lib/error-dialog/error-dialog.component.ts:50</a></div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="displayedButtons"></a> <span class="name"> <span class="modifier">Public</span> <span class="modifier">Readonly</span> <span ><b>displayedButtons</b></span> <a href="#displayedButtons"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <i>Default value : </i><code>computed(() &#x3D;&gt; { const start &#x3D; Math.max(0, this.activeIndex() - 2); const end &#x3D; Math.min(this.data().length, start + 5); return Array.from({ length: end - start }, (_, i) &#x3D;&gt; start + i); })</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-line">Defined in <a href="" data-line="55" class="link-to-prism">src/lib/error-dialog/error-dialog.component.ts:55</a></div> </td> </tr> </tbody> </table> </section> </div> <div class="tab-pane fade tab-source-code" id="source"> <pre class="line-numbers compodoc-sourcecode"><code class="language-typescript">import { ComponentPortal, PortalModule, } from &#x27;@angular/cdk/portal&#x27;; import { NgClass, NgForOf, NgIf, } from &#x27;@angular/common&#x27;; import { AfterViewInit, ChangeDetectionStrategy, Component, computed, ElementRef, EventEmitter, inject, INJECTOR, Injector, Output, signal, Signal, ViewChild, } from &#x27;@angular/core&#x27;; import { RXAP_ERROR_DIALOG_COMPONENT, RXAP_ERROR_DIALOG_DATA, RXAP_ERROR_DIALOG_ERROR, } from &#x27;../tokens&#x27;; export interface IErrorDialogComponent&lt;Error &#x3D; any&gt; { error: Error; } @Component({ selector: &#x27;rxap-error-dialog&#x27;, templateUrl: &#x27;./error-dialog.component.html&#x27;, styleUrls: [&#x27;./error-dialog.component.scss&#x27;], changeDetection: ChangeDetectionStrategy.Default, imports: [ NgIf, NgClass, NgForOf, PortalModule, ] }) export class ErrorDialogComponent implements AfterViewInit { @ViewChild(&#x27;dialog&#x27;, { static: true }) public dialog!: ElementRef&lt;HTMLDialogElement&gt;; public readonly data: Signal&lt;any[]&gt; &#x3D; inject(RXAP_ERROR_DIALOG_DATA); public readonly activeIndex &#x3D; signal(0); public readonly displayedButtons &#x3D; computed(() &#x3D;&gt; { const start &#x3D; Math.max(0, this.activeIndex() - 2); const end &#x3D; Math.min(this.data().length, start + 5); return Array.from({ length: end - start }, (_, i) &#x3D;&gt; start + i); }); @Output() public closeDialog &#x3D; new EventEmitter&lt;void&gt;(); private readonly component &#x3D; inject(RXAP_ERROR_DIALOG_COMPONENT); private readonly injector &#x3D; inject(INJECTOR); public readonly componentPortal &#x3D; computed(() &#x3D;&gt; { const index &#x3D; this.activeIndex(); const data &#x3D; this.data(); const injector &#x3D; Injector.create({ parent: this.injector, providers: [ { provide: RXAP_ERROR_DIALOG_ERROR, useValue: data[index], }, ], }); return new ComponentPortal(this.component, null, injector); }); ngAfterViewInit() { this.dialog.nativeElement.showModal(); } close() { this.dialog.nativeElement.close(); this.closeDialog.emit(); } } </code></pre> </div> <div class="tab-pane fade " id="templateData"> <pre class="line-numbers"><code class="language-html">&lt;dialog #dialog class&#x3D;&quot;rounded overflow-auto drop-shadow-2xl bg-white text-black dark:bg-black dark:text-white flex flex-col gap-3 p-6&quot; style&#x3D;&quot;max-width: 80vw; max-height: 80vh&quot;&gt; &lt;div *ngIf&#x3D;&quot;data().length &gt; 1&quot; class&#x3D;&quot;controls flex justify-center space-x-2 mt-4&quot;&gt; &lt;button (click)&#x3D;&quot;activeIndex.set(activeIndex() - 1)&quot; *ngIf&#x3D;&quot;activeIndex() &gt; 0&quot; class&#x3D;&quot;px-4 py-2 bg-gray-200 dark:bg-gray-800 dark:hover:bg-gray-900 hover:bg-gray-300 transition-colors duration-150 rounded&quot;&gt;Previous &lt;/button&gt; &lt;button (click)&#x3D;&quot;activeIndex.set(item)&quot; *ngFor&#x3D;&quot;let item of displayedButtons()&quot; [ngClass]&#x3D;&quot;{ &#x27;bg-primary-500&#x27;: item &#x3D;&#x3D;&#x3D; activeIndex(), &#x27;bg-gray-200 dark:bg-gray-800 dark:hover:bg-gray-900 hover:bg-gray-300 transition-colors duration-150&#x27;: item !&#x3D;&#x3D; activeIndex() }&quot; class&#x3D;&quot;px-4 py-2 rounded&quot;&gt; {{ item + 1 }} &lt;/button&gt; &lt;button (click)&#x3D;&quot;activeIndex.set(activeIndex() + 1)&quot; *ngIf&#x3D;&quot;activeIndex() &lt; data().length - 1&quot; class&#x3D;&quot;px-4 py-2 bg-gray-200 dark:bg-gray-800 dark:hover:bg-gray-900 hover:bg-gray-300 transition-colors duration-150 rounded&quot;&gt;Next &lt;/button&gt; &lt;/div&gt; &lt;div class&#x3D;&quot;flex flex-col overflow-auto&quot;&gt; &lt;ng-template [cdkPortalOutlet]&#x3D;&quot;componentPortal()&quot;&gt;&lt;/ng-template&gt; &lt;/div&gt; &lt;button (click)&#x3D;&quot;close()&quot; class&#x3D;&quot;px-4 py-2 rounded bg-primary-500&quot; i18n&gt;close&lt;/button&gt; &lt;/dialog&gt; </code></pre> </div> <div class="tab-pane fade " id="styleData"> <p class="comment"> <code>./error-dialog.component.scss</code> </p> <pre class="line-numbers"><code class="language-scss">dialog::backdrop { background: rgba(0, 0, 0, 0.7); } </code></pre> </div> <div class="tab-pane fade " id="tree"> <div id="tree-container"></div> <div class="tree-legend"> <div class="title"> <b>Legend</b> </div> <div> <div class="color htmlelement"></div><span>Html element</span> </div> <div> <div class="color component"></div><span>Component</span> </div> <div> <div class="color directive"></div><span>Html element with directive</span> </div> </div> </div> </div> <script src="../js/libs/vis.min.js"></script> <script src="../js/libs/htmlparser.js"></script> <script src="../js/libs/deep-iterator.js"></script> <script> var COMPONENT_TEMPLATE = '<div><dialog #dialog class="rounded overflow-auto drop-shadow-2xl bg-white text-black dark:bg-black dark:text-white flex flex-col gap-3 p-6" style="max-width: 80vw; max-height: 80vh"> <div *ngIf="data().length > 1" class="controls flex justify-center space-x-2 mt-4"> <button (click)="activeIndex.set(activeIndex() - 1)" *ngIf="activeIndex() > 0" class="px-4 py-2 bg-gray-200 dark:bg-gray-800 dark:hover:bg-gray-900 hover:bg-gray-300 transition-colors duration-150 rounded">Previous </button> <button (click)="activeIndex.set(item)" *ngFor="let item of displayedButtons()" [ngClass]="{ \'bg-primary-500\': item === activeIndex(), \'bg-gray-200 dark:bg-gray-800 dark:hover:bg-gray-900 hover:bg-gray-300 transition-colors duration-150\': item !== activeIndex() }" class="px-4 py-2 rounded"> {{ item + 1 }} </button> <button (click)="activeIndex.set(activeIndex() + 1)" *ngIf="activeIndex() < data().length - 1" class="px-4 py-2 bg-gray-200 dark:bg-gray-800 dark:hover:bg-gray-900 hover:bg-gray-300 transition-colors duration-150 rounded">Next </button> </div> <div class="flex flex-col overflow-auto"> <ng-template [cdkPortalOutlet]="componentPortal()"></ng-template> </div> <button (click)="close()" class="px-4 py-2 rounded bg-primary-500" i18n>close</button></dialog></div>' var COMPONENTS = [{'name': 'AngularErrorComponent', 'selector': 'rxap-angular-error'},{'name': 'AnyHttpErrorComponent', 'selector': 'rxap-any-http-error'},{'name': 'CodeHttpErrorComponent', 'selector': 'rxap-http-error-message'},{'name': 'ErrorDialogComponent', 'selector': 'rxap-error-dialog'},{'name': 'MessageHttpErrorComponent', 'selector': 'rxap-http-error-message'},{'name': 'OpenApiHttpResponseErrorComponent', 'selector': 'rxap-open-api-http-response-error'}]; var DIRECTIVES = []; var ACTUAL_COMPONENT = {'name': 'ErrorDialogComponent'}; </script> <script src="../js/tree.js"></script> </div><div class="search-results"> <div class="has-results"> <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1> <ul class="search-results-list"></ul> </div> <div class="no-results"> <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1> </div> </div> </div> <!-- END CONTENT --> </div> </div> <label class="dark-mode-switch"> <input type="checkbox"> <span class="slider"> <svg class="slider-icon" viewBox="0 0 24 24" fill="none" height="20" stroke="#000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" width="20" xmlns="http://www.w3.org/2000/svg"> <path d="M21 12.79A9 9 0 1111.21 3 7 7 0 0021 12.79z"></path> </svg> </span> </label> <script> var COMPODOC_CURRENT_PAGE_DEPTH = 1; var COMPODOC_CURRENT_PAGE_CONTEXT = 'component'; var COMPODOC_CURRENT_PAGE_URL = 'ErrorDialogComponent.html'; var MAX_SEARCH_RESULTS = 15; </script> <script> $darkModeToggleSwitchers = document.querySelectorAll('.dark-mode-switch input'); checkToggle(darkModeState); if ($darkModeToggleSwitchers.length > 0) { for (var i = 0; i < $darkModeToggleSwitchers.length; i++) { $darkModeToggleSwitchers[i].addEventListener('change', function (event) { darkModeState = !darkModeState; toggleDarkMode(darkModeState); }); } } </script> <script src="../js/libs/custom-elements.min.js"></script> <script src="../js/libs/lit-html.js"></script> <script src="../js/menu-wc.js" defer></script> <script nomodule src="../js/menu-wc_es5.js" defer></script> <script src="../js/libs/bootstrap-native.js"></script> <script src="../js/libs/es6-shim.min.js"></script> <script src="../js/libs/EventDispatcher.js"></script> <script src="../js/libs/promise.min.js"></script> <script src="../js/libs/zepto.min.js"></script> <script src="../js/compodoc.js"></script> <script src="../js/tabs.js"></script> <script src="../js/menu.js"></script> <script src="../js/libs/clipboard.min.js"></script> <script src="../js/libs/prism.js"></script> <script src="../js/sourceCode.js"></script> <script src="../js/search/search.js"></script> <script src="../js/search/lunr.min.js"></script> <script src="../js/search/search-lunr.js"></script> <script src="../js/search/search_index.js"></script> <script src="../js/lazy-load-graphs.js"></script> </body> </html>