npm - @qubit-ltd/logging - Versions diffs - 1.4.4 - Mend

@qubit-ltd/logging 1.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (54) hide show

package/LICENSE +201 -0
package/README.md +224 -0
package/README.zh_CN.md +200 -0
package/dist/logging.cjs +1338 -0
package/dist/logging.cjs.map +1 -0
package/dist/logging.iife.js +1342 -0
package/dist/logging.iife.js.map +1 -0
package/dist/logging.min.cjs +1 -0
package/dist/logging.min.cjs.map +1 -0
package/dist/logging.min.iife.js +1 -0
package/dist/logging.min.iife.js.map +1 -0
package/dist/logging.min.mjs +1 -0
package/dist/logging.min.mjs.map +1 -0
package/dist/logging.mjs +1330 -0
package/dist/logging.mjs.map +1 -0
package/doc/api/Logger.html +3352 -0
package/doc/api/fonts/OpenSans-Bold-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-Bold-webfont.svg +1838 -0
package/doc/api/fonts/OpenSans-Bold-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-BoldItalic-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-BoldItalic-webfont.svg +1838 -0
package/doc/api/fonts/OpenSans-BoldItalic-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-Italic-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-Italic-webfont.svg +1838 -0
package/doc/api/fonts/OpenSans-Italic-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-Light-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-Light-webfont.svg +1839 -0
package/doc/api/fonts/OpenSans-Light-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-LightItalic-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-LightItalic-webfont.svg +1843 -0
package/doc/api/fonts/OpenSans-LightItalic-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-Regular-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-Regular-webfont.svg +1839 -0
package/doc/api/fonts/OpenSans-Regular-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-Semibold-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-Semibold-webfont.svg +1838 -0
package/doc/api/fonts/OpenSans-Semibold-webfont.ttf +0 -0
package/doc/api/fonts/OpenSans-Semibold-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-SemiboldItalic-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-SemiboldItalic-webfont.svg +1838 -0
package/doc/api/fonts/OpenSans-SemiboldItalic-webfont.ttf +0 -0
package/doc/api/fonts/OpenSans-SemiboldItalic-webfont.woff +0 -0
package/doc/api/global.html +787 -0
package/doc/api/index.html +257 -0
package/doc/api/scripts/linenumber.js +34 -0
package/doc/api/scripts/prettify/Apache-License-2.0.txt +202 -0
package/doc/api/scripts/prettify/lang-css.js +2 -0
package/doc/api/scripts/prettify/prettify.js +28 -0
package/doc/api/styles/jsdoc-default.css +699 -0
package/doc/api/styles/prettify-jsdoc.css +120 -0
package/doc/api/styles/prettify-tomorrow.css +141 -0
package/doc/logging.min.visualization.html +4949 -0
package/doc/logging.visualization.html +4949 -0
package/package.json +103 -0

package/doc/api/Logger.html ADDED Viewed

@@ -0,0 +1,3352 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <title>Logger - Documentation</title>
+    <script src="scripts/prettify/prettify.js"></script>
+    <script src="scripts/prettify/lang-css.js"></script>
+    <!--[if lt IE 9]>
+      <script src="https://cdn.bootcdn.net/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="https://cdn.bootcdn.net/ajax/libs/ionicons/2.0.1/css/ionicons.min.css">
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+</head>
+<body>
+<input type="checkbox" id="nav-trigger" class="nav-trigger" />
+<label for="nav-trigger" class="navicon-button x">
+  <div class="navicon"></div>
+</label>
+<label for="nav-trigger" class="overlay"></label>
+<nav>
+    <li class="nav-link nav-home-link"><a href="index.html">Home</a></li><li class="nav-heading">Classes</li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="Logger.html">Logger</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#disable">disable</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#enable">enable</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#getAppender">getAppender</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#getLevel">getLevel</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#getName">getName</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#log">log</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#setAppender">setAppender</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#setEnabled">setEnabled</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#setLevel">setLevel</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.clearAllLoggers">clearAllLoggers</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.getDefaultAppender">getDefaultAppender</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.getDefaultLevel">getDefaultLevel</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.getLogger">getLogger</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.getLoggerLevel">getLoggerLevel</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.reset">reset</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.resetAllAppenders">resetAllAppenders</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.resetAllLevels">resetAllLevels</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.resetDefaultAppender">resetDefaultAppender</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.resetDefaultLevel">resetDefaultLevel</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.setAllAppenders">setAllAppenders</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.setAllLevels">setAllLevels</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.setDefaultAppender">setDefaultAppender</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.setDefaultLevel">setDefaultLevel</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="Logger.html#.setLoggerLevel">setLoggerLevel</a></span></li><li class="nav-heading"><a href="global.html">Globals</a></li><li class="nav-item"><span class="nav-item-type type-member">M</span><span class="nav-item-name"><a href="global.html#FACTORY_DEFAULT_APPENDER">FACTORY_DEFAULT_APPENDER</a></span></li><li class="nav-item"><span class="nav-item-type type-member">M</span><span class="nav-item-name"><a href="global.html#FACTORY_DEFAULT_LEVEL">FACTORY_DEFAULT_LEVEL</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#HasLogger">HasLogger</a></span></li><li class="nav-item"><span class="nav-item-type type-member">M</span><span class="nav-item-name"><a href="global.html#LOGGING_LEVELS">LOGGING_LEVELS</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#Log">Log</a></span></li>
+</nav>
+<div id="main">
+    <h1 class="page-title">Logger</h1>
+<section>
+<header>
+        <h2>
+        Logger
+        </h2>
+            <div class="class-description"><p>A simple logging class.</p>
+<p>A <code>Logger</code> object provides the following logging methods:</p>
+<ul>
+<li><code>Logger.trace(message, arg1, arg2, ...)</code>: Outputs a log message with the <code>TRACE</code> level.</li>
+<li><code>Logger.debug(message, arg1, arg2, ...)</code>: Outputs a log message with the <code>DEBUG</code> level.</li>
+<li><code>Logger.info(message, arg1, arg2, ...)</code>: Outputs a log message with the <code>INFO</code> level.</li>
+<li><code>Logger.warn(message, arg1, arg2, ...)</code>: Outputs a log message with the <code>WARN</code> level.</li>
+<li><code>Logger.error(message, arg1, arg2, ...)</code>: Outputs a log message with the <code>ERROR</code> level.</li>
+<li><code>Logger.log(level, message, arg1, arg2, ...)</code>: Outputs a log message with the specified level.</li>
+</ul>
+<p>The message argument of those logging methods supports the following
+substitution patterns:</p>
+<ul>
+<li><code>%o</code> or <code>%O</code>: Outputs a JavaScript object. Clicking the object name opens
+more information about it in the inspector.</li>
+<li><code>%d</code> or <code>%i</code>: Outputs an integer. Number formatting is supported, for
+example <code>logger.info('Foo %.2d', 1.1)</code> will output the number as two
+significant figures with a leading 0: <code>Foo 01</code>.</li>
+<li><code>%s</code>: Outputs a string.</li>
+<li><code>%f</code>: Outputs a floating-point value. Formatting is supported, for example
+<code>logger.debug(&quot;Foo %.2f&quot;, 1.1)</code> will output the number to 2 decimal
+places: <code>Foo 1.10</code>.</li>
+</ul></div>
+</header>
+<article>
+    <div class="container-overview">
+<div class="section-method">
+    <h2>Constructor</h2>
+    <h4 class="name" id="Logger"><span class="type-signature"></span>new Logger<span class="signature">(name, appender, level)</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Construct a log object.</p>
+<p><strong>NOTE</strong>: Do NOT call this constructor directly. Use the static method
+<code>Logger.getLogger()</code> instead.</p>
+</div>
+<dl class="details">
+    <dt class="tag-author">Author:</dt>
+    <dd class="tag-author">
+        <ul>
+            <li>Haixing Hu</li>
+        </ul>
+    </dd>
+    <dt class="tag-see">See:</dt>
+    <dd class="tag-see">
+        <ul>
+            <li><a href="Logger.html#.getLogger">Logger.getLogger</a></li>
+        </ul>
+    </dd>
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>name</code></td>
+            <td class="type">
+<span class="param-type"><code>string</code></span>
+            </td>
+            <td class="description last">
+                <p>The optional name of this logger. The default value of this argument
+is an empty string.</p>
+            </td>
+        </tr>
+        <tr>
+                <td class="name"><code>appender</code></td>
+            <td class="type">
+<span class="param-type"><code>object</code></span>
+            </td>
+            <td class="description last">
+                <p>Optional, indicating the content output pipe of the log. This object
+must provide <code>trace</code>, <code>debug</code>, <code>info</code>, <code>warn</code> and <code>error</code> methods.
+The default value of this argument is <code>Logger.getDefaultAppender()</code>.</p>
+            </td>
+        </tr>
+        <tr>
+                <td class="name"><code>level</code></td>
+            <td class="type">
+<span class="param-type"><code>string</code></span>
+            </td>
+            <td class="description last">
+                <p>Optional, indicating the log level of this object. The default value
+of this argument is <code>Logger.getDefaultLevel()</code>.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+</div>
+    </div>
+        <h3 class="subsection-title">Methods</h3>
+<div class="section-method">
+    <h4 class="name" id="disable"><span class="type-signature"></span>disable<span class="signature">()</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Disable this logging object.</p>
+</div>
+<dl class="details">
+</dl>
+</div>
+<div class="section-method">
+    <h4 class="name" id="enable"><span class="type-signature"></span>enable<span class="signature">()</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Enable this logging object.</p>
+</div>
+<dl class="details">
+</dl>
+</div>
+<div class="section-method">
+    <h4 class="name" id="getAppender"><span class="type-signature"></span>getAppender<span class="signature">()</span><span class="type-signature"> &rarr; {object}</span></h4>
+<div class="description">
+    <p>Get the appender of this logger.</p>
+</div>
+<dl class="details">
+</dl>
+<div class="section-returns">
+<h5>Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type:
+    </dt>
+    <dd>
+<span class="param-type"><code>object</code></span>
+    </dd>
+</dl>
+<div class="param-desc">
+    <p>The appender of this logger.</p>
+</div>
+</div>
+</div>
+<div class="section-method">
+    <h4 class="name" id="getLevel"><span class="type-signature"></span>getLevel<span class="signature">()</span><span class="type-signature"> &rarr; {string}</span></h4>
+<div class="description">
+    <p>Get the logging level of this logger.</p>
+</div>
+<dl class="details">
+</dl>
+<div class="section-returns">
+<h5>Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type:
+    </dt>
+    <dd>
+<span class="param-type"><code>string</code></span>
+    </dd>
+</dl>
+<div class="param-desc">
+    <p>The logging level of this logger. Possible return values are <code>TRACE</code>,
+<code>DEBUG</code>, <code>INFO</code>, <code>WARN</code>, <code>ERROR</code>, and <code>NONE</code>.</p>
+</div>
+</div>
+</div>
+<div class="section-method">
+    <h4 class="name" id="getName"><span class="type-signature"></span>getName<span class="signature">()</span><span class="type-signature"> &rarr; {string}</span></h4>
+<div class="description">
+    <p>Get the name of this logger.</p>
+</div>
+<dl class="details">
+</dl>
+<div class="section-returns">
+<h5>Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type:
+    </dt>
+    <dd>
+<span class="param-type"><code>string</code></span>
+    </dd>
+</dl>
+<div class="param-desc">
+    <p>The name of this logger.</p>
+</div>
+</div>
+</div>
+<div class="section-method">
+    <h4 class="name" id="log"><span class="type-signature"></span>log<span class="signature">(level, message, &hellip;args)</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Logs a message in the specified logging level.</p>
+</div>
+<dl class="details">
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th>Attributes</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>level</code></td>
+            <td class="type">
+<span class="param-type"><code>string</code></span>
+            </td>
+                <td class="attributes">
+                </td>
+            <td class="description last">
+                <p>the logging level.</p>
+            </td>
+        </tr>
+        <tr>
+                <td class="name"><code>message</code></td>
+            <td class="type">
+<span class="param-type"><code>string</code></span>
+            </td>
+                <td class="attributes">
+                </td>
+            <td class="description last">
+                <p>the message or message template, which may contain zero or more
+substitution patterns, e.g., '%o', '%s', '%d', '%f', ..., etc.</p>
+            </td>
+        </tr>
+        <tr>
+                <td class="name"><code>args</code></td>
+            <td class="type">
+<span class="param-type"><code>array</code></span>
+            </td>
+                <td class="attributes">
+                    &lt;repeatable><br>
+                </td>
+            <td class="description last">
+                <p>the array of arguments used to format the message.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+</div>
+<div class="section-method">
+    <h4 class="name" id="setAppender"><span class="type-signature"></span>setAppender<span class="signature">(appender)</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Set up a new Appender.</p>
+</div>
+<dl class="details">
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>appender</code></td>
+            <td class="type">
+<span class="param-type"><code>object</code></span>
+            </td>
+            <td class="description last">
+                <p>The new Appender serves as the content output pipeline of the log.
+This object must provide <code>trace</code>, <code>debug</code>, <code>info</code>, <code>warn</code> and <code>error</code>
+methods.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+</div>
+<div class="section-method">
+    <h4 class="name" id="setEnabled"><span class="type-signature"></span>setEnabled<span class="signature">(enabled)</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Enable or disable this log object.</p>
+</div>
+<dl class="details">
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>enabled</code></td>
+            <td class="type">
+<span class="param-type"><code>boolean</code></span>
+            </td>
+            <td class="description last">
+                <p>Whether to enable this log object.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+</div>
+<div class="section-method">
+    <h4 class="name" id="setLevel"><span class="type-signature"></span>setLevel<span class="signature">(level)</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Set the logging level of this logger.</p>
+</div>
+<dl class="details">
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>level</code></td>
+            <td class="type">
+<span class="param-type"><code>string</code></span>
+            </td>
+            <td class="description last">
+                <p>The new logging level. The allowed levels are <code>TRACE</code>, <code>DEBUG</code>, <code>INFO</code>,
+<code>WARN</code>, <code>ERROR</code>, and <code>NONE</code>. Lowercase letters are also allowed.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".clearAllLoggers"><span class="type-signature">(static) </span>clearAllLoggers<span class="signature">()</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Clears all existing <code>Logger</code> instances.</p>
+</div>
+<dl class="details">
+</dl>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".getDefaultAppender"><span class="type-signature">(static) </span>getDefaultAppender<span class="signature">()</span><span class="type-signature"> &rarr; {Object}</span></h4>
+<div class="description">
+    <p>Gets the default logging appender.</p>
+<p>The default logging appender is used to construct a new <code>Logger</code> instance
+if the logging appender of the new instance is not specified.</p>
+</div>
+<dl class="details">
+    <dt class="tag-see">See:</dt>
+    <dd class="tag-see">
+        <ul>
+            <li><a href="Logger.html#.setDefaultAppender">Logger.setDefaultAppender</a></li>
+            <li><a href="Logger.html#.setAllAppenders">Logger.setAllAppenders</a></li>
+            <li><a href="Logger.html#.resetAllAppenders">Logger.resetAllAppenders</a></li>
+        </ul>
+    </dd>
+</dl>
+<div class="section-returns">
+<h5>Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type:
+    </dt>
+    <dd>
+<span class="param-type"><code>Object</code></span>
+    </dd>
+</dl>
+<div class="param-desc">
+    <p>The default logging appender.</p>
+</div>
+</div>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".getDefaultLevel"><span class="type-signature">(static) </span>getDefaultLevel<span class="signature">()</span><span class="type-signature"> &rarr; {string}</span></h4>
+<div class="description">
+    <p>Gets the default logging level.</p>
+<p>The default logging level is used to construct a new <code>Logger</code> instance if
+the logging level of the new instance is not specified.</p>
+</div>
+<dl class="details">
+    <dt class="tag-see">See:</dt>
+    <dd class="tag-see">
+        <ul>
+            <li><a href="Logger.html#.setDefaultLevel">Logger.setDefaultLevel</a></li>
+            <li><a href="Logger.html#.setAllLevels">Logger.setAllLevels</a></li>
+            <li><a href="Logger.html#.resetAllLevels">Logger.resetAllLevels</a></li>
+        </ul>
+    </dd>
+</dl>
+<div class="section-returns">
+<h5>Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type:
+    </dt>
+    <dd>
+<span class="param-type"><code>string</code></span>
+    </dd>
+</dl>
+<div class="param-desc">
+    <p>The global default logging level.</p>
+</div>
+</div>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".getLogger"><span class="type-signature">(static) </span>getLogger<span class="signature">(name, options)</span><span class="type-signature"> &rarr; {<a href="Logger.html">Logger</a>}</span></h4>
+<div class="description">
+    <p>Gets the <code>Logger</code> instance of the specified name, or constructs a new
+<code>Logger</code> instance if it does not exist.</p>
+</div>
+<dl class="details">
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>name</code></td>
+            <td class="type">
+<span class="param-type"><code>string</code></span>
+            </td>
+            <td class="description last">
+                <p>The name of the <code>Logger</code> instance to be retrieved.</p>
+            </td>
+        </tr>
+        <tr>
+                <td class="name"><code>options</code></td>
+            <td class="type">
+<span class="param-type"><code>Object</code></span>
+            </td>
+            <td class="description last">
+                <p>The optional options of the <code>Logger</code> instance to be retrieved. This
+option object may have the following properties:
+- <code>appender: object</code>: the specified content output pipe of the log.
+This object must provide <code>trace</code>, <code>debug</code>, <code>info</code>, <code>warn</code> and <code>error</code>
+methods. If this option is not provided, the appender of the existing
+<code>Logger</code> instance will not be changed, and the default appender
+will be used to construct a new <code>Logger</code> instance if it does not exist.
+- <code>level: string</code>: the logging level of the <code>Logger</code> instance to be
+retrieved. The allowed levels are <code>TRACE</code>, <code>DEBUG</code>, <code>INFO</code>, <code>WARN</code>,
+<code>ERROR</code>, and <code>NONE</code>. Lowercase letters are also allowed. If this
+option is not provided, the logging level of the existing <code>Logger</code>
+instance will not be changed, and the default logging level will be
+used to construct a new <code>Logger</code> instance if it does not exist.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+<div class="section-returns">
+<h5>Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type:
+    </dt>
+    <dd>
+<span class="param-type"><code><a href="Logger.html">Logger</a></code></span>
+    </dd>
+</dl>
+<div class="param-desc">
+    <p>The <code>Logger</code> instance of the specified name, which either be the
+existing one or a newly constructed one.</p>
+</div>
+</div>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".getLoggerLevel"><span class="type-signature">(static) </span>getLoggerLevel<span class="signature">(name)</span><span class="type-signature"> &rarr; {string}</span></h4>
+<div class="description">
+    <p>Gets the logging level of the <code>Logger</code> instance of the specified name.</p>
+</div>
+<dl class="details">
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>name</code></td>
+            <td class="type">
+            </td>
+            <td class="description last">
+                <p>The name of the <code>Logger</code> instance.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+<div class="section-returns">
+<h5>Returns:</h5>
+<dl class="param-type">
+    <dt>
+        Type:
+    </dt>
+    <dd>
+<span class="param-type"><code>string</code></span>
+    </dd>
+</dl>
+<div class="param-desc">
+    <p>The logging level of the <code>Logger</code> instance of the specified name. If the
+<code>Logger</code> instance of the specified name does not exist, the default
+logging level will be returned.</p>
+</div>
+</div>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".reset"><span class="type-signature">(static) </span>reset<span class="signature">()</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Resets all configurations of the <code>Logger</code> class to the factory values.</p>
+<p>This method is equivalent to calling the following methods in sequence:</p>
+<ul>
+<li><code>Logger.clearAllLoggers()</code></li>
+<li><code>Logger.resetDefaultLevel()</code></li>
+<li><code>Logger.resetDefaultAppender()</code></li>
+</ul>
+</div>
+<dl class="details">
+</dl>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".resetAllAppenders"><span class="type-signature">(static) </span>resetAllAppenders<span class="signature">()</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Sets the appender of all <code>Logger</code> instants to the default appender.</p>
+</div>
+<dl class="details">
+    <dt class="tag-see">See:</dt>
+    <dd class="tag-see">
+        <ul>
+            <li><a href="Logger.html#.getDefaultAppender">Logger.getDefaultAppender</a></li>
+            <li><a href="Logger.html#.setDefaultAppender">Logger.setDefaultAppender</a></li>
+            <li><a href="Logger.html#.setAllAppenders">Logger.setAllAppenders</a></li>
+        </ul>
+    </dd>
+</dl>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".resetAllLevels"><span class="type-signature">(static) </span>resetAllLevels<span class="signature">()</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Sets the logging level of all <code>Logger</code> instants to the default logging level.</p>
+</div>
+<dl class="details">
+    <dt class="tag-see">See:</dt>
+    <dd class="tag-see">
+        <ul>
+            <li><a href="Logger.html#.getDefaultLevel">Logger.getDefaultLevel</a></li>
+            <li><a href="Logger.html#.setDefaultLevel">Logger.setDefaultLevel</a></li>
+            <li><a href="Logger.html#.setAllLevels">Logger.setAllLevels</a></li>
+        </ul>
+    </dd>
+</dl>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".resetDefaultAppender"><span class="type-signature">(static) </span>resetDefaultAppender<span class="signature">()</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Resets the default logging appender to the factory value.</p>
+<p>The default logging appender is used to construct a new <code>Logger</code> instance
+if the logging appender of the new instance is not specified.</p>
+</div>
+<dl class="details">
+    <dt class="tag-see">See:</dt>
+    <dd class="tag-see">
+        <ul>
+            <li><a href="Logger.html#.getDefaultAppender">Logger.getDefaultAppender</a></li>
+        </ul>
+    </dd>
+</dl>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".resetDefaultLevel"><span class="type-signature">(static) </span>resetDefaultLevel<span class="signature">()</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Resets the default logging level to the factory value.</p>
+<p>The default logging level is used to construct a new <code>Logger</code> instance if
+the logging level of the new instance is not specified.</p>
+</div>
+<dl class="details">
+</dl>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".setAllAppenders"><span class="type-signature">(static) </span>setAllAppenders<span class="signature">(appender)</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Sets the appender of all <code>Logger</code> instants.</p>
+</div>
+<dl class="details">
+    <dt class="tag-see">See:</dt>
+    <dd class="tag-see">
+        <ul>
+            <li><a href="Logger.html#.getDefaultAppender">Logger.getDefaultAppender</a></li>
+            <li><a href="Logger.html#.setDefaultAppender">Logger.setDefaultAppender</a></li>
+            <li><a href="Logger.html#.resetAllAppenders">Logger.resetAllAppenders</a></li>
+        </ul>
+    </dd>
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>appender</code></td>
+            <td class="type">
+<span class="param-type"><code>object</code></span>
+            </td>
+            <td class="description last">
+                <p>The new appender to be set, indicating the content output pipe of the
+log. This object must provide <code>trace</code>, <code>debug</code>, <code>info</code>, <code>warn</code> and
+<code>error</code> methods.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".setAllLevels"><span class="type-signature">(static) </span>setAllLevels<span class="signature">(level)</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Sets the logging level of all existing <code>Logger</code> instants.</p>
+</div>
+<dl class="details">
+    <dt class="tag-see">See:</dt>
+    <dd class="tag-see">
+        <ul>
+            <li><a href="Logger.html#.getDefaultLevel">Logger.getDefaultLevel</a></li>
+            <li><a href="Logger.html#.setDefaultLevel">Logger.setDefaultLevel</a></li>
+            <li><a href="Logger.html#.resetAllLevels">Logger.resetAllLevels</a></li>
+        </ul>
+    </dd>
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>level</code></td>
+            <td class="type">
+<span class="param-type"><code>string</code></span>
+            </td>
+            <td class="description last">
+                <p>The new logging level of all existing <code>Logger</code> instants. The allowed
+levels are <code>TRACE</code>, <code>DEBUG</code>, <code>INFO</code>, <code>WARN</code>, <code>ERROR</code>, and <code>NONE</code>.
+Lowercase letters are also allowed.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".setDefaultAppender"><span class="type-signature">(static) </span>setDefaultAppender<span class="signature">(appender)</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Sets the default logging appender.</p>
+<p>The default logging appender is used to construct a new <code>Logger</code> instance
+if the logging appender of the new instance is not specified.</p>
+</div>
+<dl class="details">
+    <dt class="tag-see">See:</dt>
+    <dd class="tag-see">
+        <ul>
+            <li><a href="Logger.html#.getDefaultAppender">Logger.getDefaultAppender</a></li>
+            <li><a href="Logger.html#.setAllAppenders">Logger.setAllAppenders</a></li>
+            <li><a href="Logger.html#.resetAllAppenders">Logger.resetAllAppenders</a></li>
+        </ul>
+    </dd>
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>appender</code></td>
+            <td class="type">
+<span class="param-type"><code>object</code></span>
+            </td>
+            <td class="description last">
+                <p>The new default logging appender.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".setDefaultLevel"><span class="type-signature">(static) </span>setDefaultLevel<span class="signature">(level)</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Sets the default logging level.</p>
+<p>The default logging level is used to construct a new <code>Logger</code> instance if
+the logging level of the new instance is not specified.</p>
+</div>
+<dl class="details">
+    <dt class="tag-see">See:</dt>
+    <dd class="tag-see">
+        <ul>
+            <li><a href="Logger.html#.getDefaultLevel">Logger.getDefaultLevel</a></li>
+            <li><a href="Logger.html#.setAllLevels">Logger.setAllLevels</a></li>
+            <li><a href="Logger.html#.resetAllLevels">Logger.resetAllLevels</a></li>
+        </ul>
+    </dd>
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>level</code></td>
+            <td class="type">
+<span class="param-type"><code>string</code></span>
+            </td>
+            <td class="description last">
+                <p>The new default logging level. The allowed levels are <code>TRACE</code>, <code>DEBUG</code>,
+<code>INFO</code>, <code>WARN</code>, <code>ERROR</code>, and <code>NONE</code>. Lowercase letters are also allowed.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+</div>
+<div class="section-method">
+    <h4 class="name" id=".setLoggerLevel"><span class="type-signature">(static) </span>setLoggerLevel<span class="signature">(name, level)</span><span class="type-signature"></span></h4>
+<div class="description">
+    <p>Sets the logging level of the <code>Logger</code> instance of the specified name.</p>
+</div>
+<dl class="details">
+</dl>
+    <h5>Parameters:</h5>
+<table class="params">
+    <thead>
+    <tr>
+        <th>Name</th>
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+        <tr>
+                <td class="name"><code>name</code></td>
+            <td class="type">
+            </td>
+            <td class="description last">
+                <p>The name of the <code>Logger</code> instance.</p>
+            </td>
+        </tr>
+        <tr>
+                <td class="name"><code>level</code></td>
+            <td class="type">
+            </td>
+            <td class="description last">
+                <p>The new logging level of the <code>Logger</code> instance of the specified name.
+The allowed levels are <code>TRACE</code>, <code>DEBUG</code>, <code>INFO</code>, <code>WARN</code>, <code>ERROR</code>,
+and <code>NONE</code>. Lowercase letters are also allowed.</p>
+            </td>
+        </tr>
+    </tbody>
+</table>
+</div>
+</article>
+</section>
+</div>
+<br class="clear">
+<footer>
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.4</a>
+     on Sun Jan 05 2025 14:29:26 GMT+0800 (China Standard Time)
+    using the <a href="https://github.com/Haixing-Hu/jsdoc-minami">customized Minami theme</a>.
+</footer>
+<script>prettyPrint();</script>
+<script src="scripts/linenumber.js"></script>
+</body>
+</html>