Browse Source

Documented ASP.NET Core MVC / Razor Pages UI: JavaScript Logging API

pull/5869/head
Halil İbrahim Kalkan 6 years ago
parent
commit
69b53982a8
  1. 2
      docs/en/UI/AspNetCore/JavaScript-API/Index.md
  2. 49
      docs/en/UI/AspNetCore/JavaScript-API/Logging.md
  3. 4
      docs/en/docs-nav.json

2
docs/en/UI/AspNetCore/JavaScript-API/Index.md

@ -11,7 +11,7 @@ ABP provides a set of JavaScript APIs for ASP.NET Core MVC / Razor Pages applica
* [abp.event](Events.md)
* [abp.features](Features.md)
* [abp.localization](Localization.md)
* abp.log
* [abp.log](Logging.md)
* [abp.message](Message.md)
* [abp.notify](Notify.md)
* abp.security

49
docs/en/UI/AspNetCore/JavaScript-API/Logging.md

@ -1,3 +1,50 @@
# ASP.NET Core MVC / Razor Pages UI: JavaScript Logging API
TODO
`abp.log` API is used to write simple logs in the client side.
> The logs are written to console, using the `console.log`, by default.
> This document is for simple client side logging. See the [Logging](../../../Logging.md) document for server side logging system.
## Basic Usage
Use one of the `abp.log.xxx(...)` methods based on the severity of your log message.
````js
abp.log.debug("Some debug log here..."); //Logging a simple debug message
abp.log.info({ name: "john", age: 42 }); //Logging an object as an information log
abp.log.warn("A warning message"); //Logging a warning message
abp.log.error('An error happens...'); //Error message
abp.log.fatal('Network connection has gone away!'); //Fatal error
````
## Log Levels
There are 5 levels for a log message:
* DEBUG = 1
* INFO = 2
* WARN = 3
* ERROR = 4
* FATAL = 5
These are defined in the `abp.log.levels` object (like `abp.log.levels.WARN`).
### Changing the Current Log Level
You can control the log level as shown below:
````js
abp.log.level = abp.log.levels.WARN;
````
Default log level is `DEBUG`.
### Logging with Specifying the Level
Instead of calling `abp.log.info(...)` function, you can use the `abp.log.log` by specifying the log level as a parameter:
````js
abp.log.log("log message...", abp.log.levels.INFO);
````

4
docs/en/docs-nav.json

@ -490,6 +490,10 @@
{
"text": "DOM",
"path": "UI/AspNetCore/JavaScript-API/DOM.md"
},
{
"text": "Logging",
"path": "UI/AspNetCore/JavaScript-API/Logging.md"
}
]
},

Loading…
Cancel
Save