feat(config): validate config after load_config

lib/hexo/index.js

@@ -229,6 +229,7 @@ class Hexo extends EventEmitter {
     return Promise.each([
       'update_package', // Update package.json
       'load_config', // Load config
+      'validate_config', // Validate config
       'load_theme_config', // Load alternate theme config
       'load_plugins' // Load external plugins & scripts
     ], name => require(`./${name}`)(this)).then(() => this.execFilter('after_init', null, {context: this})).then(() => {

lib/hexo/validate_config.js

@@ -0,0 +1,33 @@
+'use strict';
+
+module.exports = ctx => {
+  const { config, log } = ctx;
+
+  log.info('Validating config');
+
+  // Validation for config.url && config.root
+  if (typeof config.url !== 'string') {
+    throw new TypeError('_config.yml validation failed, "url" should be string!');
+  }
+  if (config.url.trim().length <= 0) {
+    throw new TypeError('_config.yml validation failed, "url" should not be empty!');
+  }
+
+  if (typeof config.root !== 'string') {
+    throw new TypeError('_config.yml validation failed, "root" should be string!');
+  }
+  if (config.root.trim().length <= 0) {
+    throw new TypeError('_config.yml validation failed, "root" should not be empty!');
+  }
+
+  // Soft deprecate use_date_for_updated
+  if (typeof config.use_date_for_updated === 'boolean') {
+    log.warn('_config.yml validation: "use_date_for_updated" is deprecated, please use "updated_option" instead. See https://hexo.io/docs/configuration for more details.');
+  }
+
+  // Soft deprecate external_link Boolean
+  if (typeof config.external_link === 'boolean') {
+    log.warn('_config.yml validation: "external_link" with a Boolean value is deprecated. See https://hexo.io/docs/configuration for more details.');
+  }
+};
+

test/scripts/hexo/index.js

@@ -3,6 +3,7 @@
 describe('Core', () => {
   require('./hexo');
   require('./load_config');
+  require('./validate_config');
   require('./load_database');
   require('./load_plugins');
   require('./load_theme_config');

test/scripts/hexo/validate_config.js

@@ -0,0 +1,102 @@
+'use strict';
+
+const { spy } = require('sinon');
+
+describe('Validate config', () => {
+  const Hexo = require('../../../lib/hexo');
+  const hexo = new Hexo();
+  const validateConfig = require('../../../lib/hexo/validate_config');
+  const defaultConfig = require('../../../lib/hexo/default_config');
+  let logSpy;
+
+  beforeEach(() => {
+    logSpy = spy();
+    hexo.config = JSON.parse(JSON.stringify(defaultConfig));
+    hexo.log.warn = logSpy;
+    hexo.log.info = spy();
+  });
+
+  it('config.url - undefined', () => {
+    delete hexo.config.url;
+
+    try {
+      validateConfig(hexo);
+    } catch (e) {
+      e.name.should.eql('TypeError');
+      e.message.should.eql('_config.yml validation failed, "url" should be string!');
+    }
+  });
+
+  it('config.url - wrong type', () => {
+    hexo.config.url = true;
+
+    try {
+      validateConfig(hexo);
+    } catch (e) {
+      e.name.should.eql('TypeError');
+      e.message.should.eql('_config.yml validation failed, "url" should be string!');
+    }
+  });
+
+  it('config.url - empty', () => {
+    hexo.config.url = ' ';
+
+    try {
+      validateConfig(hexo);
+    } catch (e) {
+      e.name.should.eql('TypeError');
+      e.message.should.eql('_config.yml validation failed, "url" should not be empty!');
+    }
+  });
+
+  it('config.root - undefined', () => {
+    delete hexo.config.root;
+
+    try {
+      validateConfig(hexo);
+    } catch (e) {
+      e.name.should.eql('TypeError');
+      e.message.should.eql('_config.yml validation failed, "root" should be string!');
+    }
+  });
+
+  it('config.root - wrong type', () => {
+    hexo.config.root = true;
+
+    try {
+      validateConfig(hexo);
+    } catch (e) {
+      e.name.should.eql('TypeError');
+      e.message.should.eql('_config.yml validation failed, "root" should be string!');
+    }
+  });
+
+  it('config.root - empty', () => {
+    hexo.config.root = ' ';
+
+    try {
+      validateConfig(hexo);
+    } catch (e) {
+      e.name.should.eql('TypeError');
+      e.message.should.eql('_config.yml validation failed, "root" should not be empty!');
+    }
+  });
+
+  it('config.use_date_for_updated - depreacte', () => {
+    hexo.config.use_date_for_updated = true;
+
+    validateConfig(hexo);
+
+    logSpy.calledOnce.should.be.true;
+    logSpy.calledWith('_config.yml validation: "use_date_for_updated" is deprecated, please use "updated_option" instead. See https://hexo.io/docs/configuration for more details.').should.be.true;
+  });
+
+  it('config.external_link - depreacte Boolean value', () => {
+    hexo.config.external_link = false;
+
+    validateConfig(hexo);
+
+    logSpy.calledOnce.should.be.true;
+    logSpy.calledWith('_config.yml validation: "external_link" with a Boolean value is deprecated. See https://hexo.io/docs/configuration for more details.').should.be.true;
+  });
+});