Babel 转译

由于框架依赖的 Node 最低版本为 6.0.0,但这个版本还不支持 async/await,所以在项目里使用 async/await 时,需要借助 Babel 转译。

Babel 会将 src/ 目录转译到 app/ 目录下,并添加对应的 sourceMap 文件。

Babel 转译规则

默认使用的 preset 为 babel-preset-think-node,在入口文件 development.js 里引用:

const Application = require('thinkjs');
const babel = require('think-babel');
const watcher = require('think-watcher');
const notifier = require('node-notifier');

const instance = new Application({
  ROOT_PATH: __dirname,
  watcher: watcher,
  transpiler: [babel, {
    presets: ['think-node'] // 默认使用 babel-preset-think-node
  }],
  notifier: notifier.notify.bind(notifier),
  env: 'development'
});

instance.run();

如果要增加presets和plugins可以增加transpiler的参数:

const Application = require('thinkjs');
const babel = require('think-babel');
const watcher = require('think-watcher');
const notifier = require('node-notifier');

const instance = new Application({
  ROOT_PATH: __dirname,
  watcher: watcher,
  transpiler: [babel, {
    presets: ['think-node',"@babel/env"], // 增加了babel 7的预设,需要升级到babel 7,6同理
    plugins: [
            ["@babel/plugin-proposal-decorators", { "legacy": true }],
            ["@babel/plugin-proposal-class-properties", { "loose": true }]
        ]//增加了babel 7的插件,6同理
  }],
  notifier: notifier.notify.bind(notifier),
  env: 'development'
});

instance.run();

babel-preset-think-node 只会转译 es2015-modules-commonjsexponentiation-operatortrailing-function-commasasync-to-generatorobject-rest-spread,如果这些转译不能满足需求的话,可以根据需要自己定制 babel preset。

关闭 Babel 转译

如果项目运行的 Node 版本大于 7.6.0(推荐使用 12.x.x LTS 版本),那么已经支持 async/await 了,就可以关闭 Babel 转译了。

创建项目时关闭转译

创建项目时可以指定 -w 参数来关闭 Babel 转译。

thinkjs new demo -w;

这样创建后,运行时不会把 src/ 转译到 app/ 目录,直接运行 src/ 目录下的代码。

删除相关代码关闭转译

已有的项目可以手工删除相关的代码来关闭转译,其实使不使用 Babel 转译,只是入口文件里和模块依赖有一些区别:

  • 有 Babel 转译的入口文件(development.js)

      const Application = require('thinkjs');
      const babel = require('think-babel');
      const watcher = require('think-watcher');
      const notifier = require('node-notifier');
    
      const instance = new Application({
        ROOT_PATH: __dirname,
        watcher: watcher, //监听器,监听文件变化
        transpiler: [babel, {  //转译器,这里使用的是 babel,并指定转译参数
          presets: ['think-node']
        }],
        notifier: notifier.notify.bind(notifier), //通知器,当转译报错时如何通知
        env: 'development'
      });
    
      instance.run();
  • 去除 Babel 转译的入口文件(development.js)

      const Application = require('thinkjs');
      const watcher = require('think-watcher');
      const instance = new Application({
        ROOT_PATH: __dirname,
        watcher: watcher,
        env: 'development'
      });
    
      instance.run();

对比可以看到,去除 Babel 转译,只是移除了 transpilernotifier 2 个配置,一个是指定转译器,一个是当转译报错时的通知处理方式,手工删除相关代码和模块依赖即可。

如发现文档中的错误,请点击这里修改本文档,修改完成后请 pull request,我们会尽快合并、更新。