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

842 lines (688 loc) 31.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 miscellaneous-functions"> <div class="content-data"> <ol class="breadcrumb"> <li class="breadcrumb-item">Miscellaneous</li> <li class="breadcrumb-item">Functions</li> </ol> <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"> <ul class="index-list"> <li> <a href="#DefaultErrorCodeExtractor" title="src/lib/error-interceptor-options.ts" ><b>DefaultErrorCodeExtractor</b>&nbsp;&nbsp;&nbsp;(src/.../error-interceptor-options.ts)</a> </li> <li> <a href="#DefaultErrorFilter" title="src/lib/error-interceptor-options.ts" ><b>DefaultErrorFilter</b>&nbsp;&nbsp;&nbsp;(src/.../error-interceptor-options.ts)</a> </li> <li> <a href="#ExtractContextFromError" title="src/lib/utilities.ts" ><b>ExtractContextFromError</b>&nbsp;&nbsp;&nbsp;(src/.../utilities.ts)</a> </li> <li> <a href="#ExtractError" title="src/lib/utilities.ts" ><b>ExtractError</b>&nbsp;&nbsp;&nbsp;(src/.../utilities.ts)</a> </li> <li> <a href="#ExtractExtraFromError" title="src/lib/utilities.ts" ><b>ExtractExtraFromError</b>&nbsp;&nbsp;&nbsp;(src/.../utilities.ts)</a> </li> <li> <a href="#ExtractTagsFromError" title="src/lib/utilities.ts" ><b>ExtractTagsFromError</b>&nbsp;&nbsp;&nbsp;(src/.../utilities.ts)</a> </li> <li> <a href="#HttpErrorInterceptor" title="src/lib/http-error-interceptor.ts" ><b>HttpErrorInterceptor</b>&nbsp;&nbsp;&nbsp;(src/.../http-error-interceptor.ts)</a> </li> <li> <a href="#initGenerator" title="src/generators/init/generator.ts" ><b>initGenerator</b>&nbsp;&nbsp;&nbsp;(src/.../generator.ts)</a> </li> <li> <a href="#PrintError" title="src/lib/utilities.ts" ><b>PrintError</b>&nbsp;&nbsp;&nbsp;(src/.../utilities.ts)</a> </li> <li> <a href="#ProvideErrorHandler" title="src/lib/error-handler.ts" ><b>ProvideErrorHandler</b>&nbsp;&nbsp;&nbsp;(src/.../error-handler.ts)</a> </li> <li> <a href="#SimplifyHttpErrorResponse" title="src/lib/utilities.ts" ><b>SimplifyHttpErrorResponse</b>&nbsp;&nbsp;&nbsp;(src/.../utilities.ts)</a> </li> </ul> </td> </tr> </tbody> </table> </section> <h3>src/lib/error-interceptor-options.ts</h3> <section data-compodoc="block-methods"> <h3></h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="DefaultErrorCodeExtractor"></a> <span class="name"> <span ><b>DefaultErrorCodeExtractor</b></span> <a href="#DefaultErrorCodeExtractor"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>DefaultErrorCodeExtractor(error: HttpErrorResponse)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Type</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>error</td> <td> <code>HttpErrorResponse</code> </td> <td> No </td> </tr> </tbody> </table> </div> <div class="io-description"> <b>Returns : </b> <code>number | string | null</code> </div> <div class="io-description"> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="DefaultErrorFilter"></a> <span class="name"> <span ><b>DefaultErrorFilter</b></span> <a href="#DefaultErrorFilter"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>DefaultErrorFilter(error: HttpErrorResponse)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Type</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>error</td> <td> <code>HttpErrorResponse</code> </td> <td> No </td> </tr> </tbody> </table> </div> <div class="io-description"> <b>Returns : </b> <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/boolean" target="_blank" >boolean</a></code> </div> <div class="io-description"> </div> </td> </tr> </tbody> </table> </section> <h3>src/lib/utilities.ts</h3> <section data-compodoc="block-methods"> <h3></h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="ExtractContextFromError"></a> <span class="name"> <span ><b>ExtractContextFromError</b></span> <a href="#ExtractContextFromError"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>ExtractContextFromError(error)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>error</td> <td> No </td> </tr> </tbody> </table> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="ExtractError"></a> <span class="name"> <span ><b>ExtractError</b></span> <a href="#ExtractError"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>ExtractError(error)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>error</td> <td> No </td> </tr> </tbody> </table> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="ExtractExtraFromError"></a> <span class="name"> <span ><b>ExtractExtraFromError</b></span> <a href="#ExtractExtraFromError"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>ExtractExtraFromError(error)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>error</td> <td> No </td> </tr> </tbody> </table> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="ExtractTagsFromError"></a> <span class="name"> <span ><b>ExtractTagsFromError</b></span> <a href="#ExtractTagsFromError"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>ExtractTagsFromError(error)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>error</td> <td> No </td> </tr> </tbody> </table> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="PrintError"></a> <span class="name"> <span ><b>PrintError</b></span> <a href="#PrintError"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>PrintError(errorCandidate)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>errorCandidate</td> <td> No </td> </tr> </tbody> </table> </div> </td> </tr> </tbody> </table> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="SimplifyHttpErrorResponse"></a> <span class="name"> <span ><b>SimplifyHttpErrorResponse</b></span> <a href="#SimplifyHttpErrorResponse"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>SimplifyHttpErrorResponse(event: HttpErrorResponse)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Type</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>event</td> <td> <code>HttpErrorResponse</code> </td> <td> No </td> </tr> </tbody> </table> </div> <div class="io-description"> <b>Returns : </b> <code><a href="../interfaces/SimplifiedHttpErrorResponse.html" target="_self" >SimplifiedHttpErrorResponse</a></code> </div> <div class="io-description"> </div> </td> </tr> </tbody> </table> </section> <h3>src/lib/http-error-interceptor.ts</h3> <section data-compodoc="block-methods"> <h3></h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="HttpErrorInterceptor"></a> <span class="name"> <span ><b>HttpErrorInterceptor</b></span> <a href="#HttpErrorInterceptor"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>HttpErrorInterceptor(req: HttpRequest, next: HttpHandlerFn)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Type</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>req</td> <td> <code>HttpRequest</code> </td> <td> No </td> </tr> <tr> <td>next</td> <td> <code>HttpHandlerFn</code> </td> <td> No </td> </tr> </tbody> </table> </div> <div class="io-description"> <b>Returns : </b> <code>Observable&lt;HttpEvent&lt;&gt;&gt;</code> </div> <div class="io-description"> </div> </td> </tr> </tbody> </table> </section> <h3>src/generators/init/generator.ts</h3> <section data-compodoc="block-methods"> <h3></h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="initGenerator"></a> <span class="name"> <span ><b>initGenerator</b></span> <a href="#initGenerator"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>initGenerator(tree: Tree, options: InitGeneratorSchema)</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Parameters :</b> <table class="params"> <thead> <tr> <td>Name</td> <td>Type</td> <td>Optional</td> </tr> </thead> <tbody> <tr> <td>tree</td> <td> <code>Tree</code> </td> <td> No </td> </tr> <tr> <td>options</td> <td> <code>InitGeneratorSchema</code> </td> <td> No </td> </tr> </tbody> </table> </div> </td> </tr> </tbody> </table> </section> <h3>src/lib/error-handler.ts</h3> <section data-compodoc="block-methods"> <h3></h3> <table class="table table-sm table-bordered"> <tbody> <tr> <td class="col-md-4"> <a name="ProvideErrorHandler"></a> <span class="name"> <span ><b>ProvideErrorHandler</b></span> <a href="#ProvideErrorHandler"><span class="icon ion-ios-link"></span></a> </span> </td> </tr> <tr> <td class="col-md-4"> <code>ProvideErrorHandler()</code> </td> </tr> <tr> <td class="col-md-4"> <div class="io-description"> <b>Returns : </b> <code>StaticProvider</code> </div> </td> </tr> </tbody> </table> </section> </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 = 'miscellaneous-functions'; var COMPODOC_CURRENT_PAGE_URL = 'functions.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>