[Feature] Log levels

dist/editor.licenses.txt

@@ -2,7 +2,7 @@
 MIT
 MIT License
 
-Copyright (c) 2014-2018 Sebastian McKenzie and other contributors
+Copyright (c) 2014-present Sebastian McKenzie and other contributors
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -28,7 +28,7 @@ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 MIT
 MIT License
 
-Copyright (c) 2014-2018 Sebastian McKenzie <sebmck@gmail.com>
+Copyright (c) 2014-present Sebastian McKenzie and other contributors
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -163,7 +163,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 core-js
 MIT
-Copyright (c) 2014-2018 Denis Pushkarev
+Copyright (c) 2014-2019 Denis Pushkarev
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -390,3 +390,24 @@ Apache License
 
 regenerator-runtime
 MIT
+MIT License
+
+Copyright (c) 2014-present, Facebook, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

docs/CHANGELOG.md

@@ -14,6 +14,7 @@
 — `Improvements` — Module Listeners now correctly removes events with options [#904](https://github.com/codex-team/editor.js/pull/904)
 — `Fix` — Fixed History Back on block deletion by Backspace in Firefox [#967](https://github.com/codex-team/editor.js/pull/967)
 - `Fix` — Fixed `getRangeCount` call if range count is 0 [#938](https://github.com/codex-team/editor.js/issues/938)
+- `New` — Log levels now available to suppress Editor.js console messages [#962](https://github.com/codex-team/editor.js/issues/962) 
 
 ### 2.15.1
 

docs/usage.md

@@ -102,4 +102,26 @@ var editor = new EditorJS({
 
 ```
 
-If you are using your custom `Initial Block`, `placeholder` property is passed in `config` to your Tool constructor.  
+If you are using your custom `Initial Block`, `placeholder` property is passed in `config` to your Tool constructor.
+
+## Log level
+
+You can specify log level for Editor.js console messages via `logLevel' property of configuration:
+
+```js
+var editor = new EditorJS({
+  //...
+  logLevel: 'WARN'
+  //..
+})
+```
+
+Possible values:
+
+| Value     | Description                  |
+| -----     | ---------------------------- |
+| `VERBOSE` | Show all messages            |
+| `INFO`    | Show info and debug messages |
+| `WARN`    | Show errors and warns only   |
+| `ERROR`   | Show errors only             |
+

src/components/block.ts

@@ -11,7 +11,7 @@ import {
 
 import {SavedData} from '../types-internal/block-data';
 import $ from './dom';
-import _ from './utils';
+import * as _ from './utils';
 
 /**
  * @class Block

src/components/blocks.ts

@@ -1,4 +1,4 @@
-import _ from './utils';
+import * as _ from './utils';
 import $ from './dom';
 import Block, {BlockToolAPI} from './block';
 

src/components/core.ts

@@ -1,7 +1,8 @@
 import $ from './dom';
-import _ from './utils';
+import * as _ from './utils';
 import {EditorConfig, OutputData, SanitizerConfig} from '../../types';
 import {EditorModules} from '../types-internal/editor-modules';
+import {LogLevels} from './utils';
 
 /**
  * @typedef {Core} Core - editor core class
@@ -75,7 +76,7 @@ export default class Core {
         await this.init();
         await this.start();
 
-        _.log('I\'m ready! (ﾉ◕ヮ◕)ﾉ*:･ﾟ✧', 'log', '', 'color: #E24A75');
+        _.logLabeled('I\'m ready! (ﾉ◕ヮ◕)ﾉ*:･ﾟ✧', 'log', '', 'color: #E24A75');
 
         setTimeout(async () => {
           await this.render();
@@ -144,6 +145,12 @@ export default class Core {
       this.config.holder = 'editorjs';
     }
 
+    if (!this.config.logLevel) {
+      this.config.logLevel = LogLevels.VERBOSE;
+    }
+
+    _.setLogLevel(this.config.logLevel);
+
     /**
      * If initial Block's Tool was not passed, use the Paragraph Tool
      */

src/components/flipper.ts

@@ -1,5 +1,5 @@
 import DomIterator from './domIterator';
-import _ from './utils';
+import * as _ from './utils';
 
 /**
  * Flipper construction options

src/components/inline-tools/inline-tool-link.ts

@@ -1,7 +1,7 @@
 import SelectionUtils from '../selection';
 
 import $ from '../dom';
-import _ from '../utils';
+import * as _ from '../utils';
 import {API, InlineTool, SanitizerConfig} from '../../../types';
 import {Notifier, Toolbar} from '../../../types/api';
 

src/components/modules/api/blocks.ts

@@ -2,7 +2,7 @@ import Module from '../../__module';
 
 import {Blocks} from '../../../../types/api';
 import {BlockToolData, OutputData, ToolConfig} from '../../../../types';
-import _ from './../../utils';
+import * as _ from './../../utils';
 
 /**
  * @class BlocksAPI

src/components/modules/blockEvents.ts

@@ -2,7 +2,7 @@
  * Contains keyboard and mouse events binded on each Block by Block Manager
  */
 import Module from '../__module';
-import _ from '../utils';
+import * as _ from '../utils';
 import SelectionUtils from '../selection';
 import Flipper from '../flipper';
 

src/components/modules/blockManager.ts

@@ -9,7 +9,7 @@
 import Block, {BlockToolAPI} from '../block';
 import Module from '../__module';
 import $ from '../dom';
-import _ from '../utils';
+import * as _ from '../utils';
 import Blocks from '../blocks';
 import {BlockTool, BlockToolConstructable, BlockToolData, PasteEvent, ToolConfig} from '../../../types';
 

src/components/modules/blockSelection.ts

@@ -7,7 +7,7 @@
  */
 import Module from '../__module';
 import Block from '../block';
-import _ from '../utils';
+import * as _ from '../utils';
 import $ from '../dom';
 
 import SelectionUtils from '../selection';

src/components/modules/caret.ts

@@ -13,7 +13,7 @@ import Selection from '../selection';
 import Module from '../__module';
 import Block from '../block';
 import $ from '../dom';
-import _ from '../utils';
+import * as _ from '../utils';
 
 /**
  * @typedef {Caret} Caret

src/components/modules/crossBlockSelection.ts

@@ -1,7 +1,7 @@
 import Module from '../__module';
 import Block from '../block';
 import SelectionUtils from '../selection';
-import _ from '../utils';
+import * as _ from '../utils';
 
 export default class CrossBlockSelection extends Module {
   /**

src/components/modules/modificationsObserver.ts

@@ -6,7 +6,7 @@
  */
 
 import Module from '../__module';
-import _ from '../utils';
+import * as _ from '../utils';
 import Block from '../block';
 
 export default class ModificationsObserver extends Module {

src/components/modules/paste.ts

@@ -1,6 +1,6 @@
 import Module from '../__module';
 import $ from '../dom';
-import _ from '../utils';
+import * as _ from '../utils';
 import {
   BlockTool,
   BlockToolConstructable,

src/components/modules/renderer.ts

@@ -1,5 +1,6 @@
 import Module from '../__module';
-import _, {ChainData} from '../utils';
+import * as _ from '../utils';
+import {ChainData} from '../utils';
 import {BlockToolData} from '../../../types';
 import {BlockToolConstructable} from '../../../types/tools';
 

src/components/modules/sanitizer.ts

@@ -17,7 +17,7 @@
  */
 
 import Module from '../__module';
-import _ from '../utils';
+import * as _ from '../utils';
 
 /**
  * @typedef {Object} SanitizerConfig

src/components/modules/saver.ts

@@ -9,6 +9,7 @@ import Module from '../__module';
 import {OutputData} from '../../../types';
 import {ValidatedData} from '../../types-internal/block-data';
 import Block from '../block';
+import * as _ from '../utils';
 
 declare const VERSION: string;
 
@@ -67,23 +68,23 @@ export default class Saver extends Module {
     let totalTime = 0;
     const blocks = [];
 
-    console.groupCollapsed('[Editor.js saving]:');
+    _.log('[Editor.js saving]:', 'groupCollapsed');
 
     allExtractedData.forEach(({tool, data, time, isValid}) => {
       totalTime += time;
 
       /**
        * Capitalize Tool name
        */
-      console.group(`${tool.charAt(0).toUpperCase() + tool.slice(1)}`);
+      _.log(`${tool.charAt(0).toUpperCase() + tool.slice(1)}`, 'group');
 
       if (isValid) {
         /** Group process info */
-        console.log(data);
-        console.groupEnd();
+        _.log(data);
+        _.log(undefined, 'groupEnd');
       } else {
-        console.log(`Block «${tool}» skipped because saved data is invalid`);
-        console.groupEnd();
+        _.log(`Block «${tool}» skipped because saved data is invalid`);
+        _.log(undefined, 'groupEnd');
         return;
       }
 
@@ -99,8 +100,8 @@ export default class Saver extends Module {
       });
     });
 
-    console.log('Total', totalTime);
-    console.groupEnd();
+    _.log('Total', 'log', totalTime);
+    _.log(undefined, 'groupEnd');
 
     return {
       time: +new Date(),

src/components/modules/toolbar/blockSettings.ts

@@ -1,7 +1,7 @@
 import Module from '../../__module';
 import $ from '../../dom';
 import Flipper, {FlipperOptions} from '../../flipper';
-import _ from '../../utils';
+import * as _ from '../../utils';
 
 /**
  * Block Settings

src/components/modules/toolbar/conversion.ts

@@ -1,7 +1,7 @@
 import Module from '../../__module';
 import $ from '../../dom';
 import {BlockToolConstructable} from '../../../../types';
-import _ from '../../utils';
+import * as _ from '../../utils';
 import {SavedData} from '../../../types-internal/block-data';
 import Block from '../../block';
 import Flipper from '../../flipper';

src/components/modules/toolbar/index.ts

@@ -1,6 +1,6 @@
 import Module from '../../__module';
 import $ from '../../dom';
-import _ from '../../utils';
+import * as _ from '../../utils';
 
 /**
  *

src/components/modules/toolbar/inline.ts

@@ -2,7 +2,7 @@ import Module from '../../__module';
 import $ from '../../dom';
 
 import SelectionUtils from '../../selection';
-import _ from '../../utils';
+import * as _ from '../../utils';
 import {InlineTool, InlineToolConstructable, ToolConstructable, ToolSettings} from '../../../../types';
 import Flipper from '../../flipper';
 

src/components/modules/toolbar/toolbox.ts

@@ -1,6 +1,6 @@
 import Module from '../../__module';
 import $ from '../../dom';
-import _ from '../../utils';
+import * as _ from '../../utils';
 import {BlockToolConstructable} from '../../../../types';
 import Flipper from '../../flipper';
 import {BlockToolAPI} from '../../block';

src/components/modules/tools.ts

@@ -1,6 +1,6 @@
 import Paragraph from '../tools/paragraph/dist/bundle';
 import Module from '../__module';
-import _ from '../utils';
+import * as _ from '../utils';
 import {
   BlockToolConstructable,
   InlineTool,

src/components/modules/ui.ts

@@ -10,7 +10,7 @@ import sprite from '../../../dist/sprite.svg';
  */
 import Module from '../__module';
 import $ from '../dom';
-import _ from '../utils';
+import * as _ from '../utils';
 
 import Selection from '../selection';
 import Block from '../block';

src/components/selection.ts

@@ -1,7 +1,7 @@
 /**
  * TextRange interface fot IE9-
  */
-import _ from './utils';
+import * as _ from './utils';
 import $ from './dom';
 
 interface TextRange {