模組化


檔案作用域

在JavaScript檔案中宣告的變數和函數只在該檔案中有效;不同的檔案中可以宣告相同名字的變數和函數,不會互相影響。

透過全域函數getApp()可以取得全域的應用實例,如果需要全域的資料可以在App()中設置,如:

// app.jsApp({
  globalData: 1
 })
// a.js
// The localValue can only be used in file a.js.
var localValue = 'a'
// Get the app instance.
var app = getApp()
// Get the global data and change it.
app.globalData++
// b.js
// You can redefine localValue in file b.js, without interference with the localValue in a.js.
var localValue = 'b'
// If a.js it run before b.js, now the globalData shoule be 2.
console.log(getApp().globalData)

模組化

我們可以將一些公共的程式碼抽離成為一個單獨的js文件,作為一個模組。模組只有透過module.exports才能對外暴露介面。

要注意的是:

  • exports 是 module.exports 的一個引用,因此在模組裡邊隨意更改  exports 的指向會造成未知的錯誤。所以我們更推薦開發者採用 module.exports 來暴露模組接口,除非你已經清晰知道這兩者的關係。
  • 小程式目前不支援直接引入 node_modules , 開發者需要使用到 node_modules 時候建議拷貝出相關的程式碼到小程式的目錄中。


// common.js
function sayHello(name) {
  console.log('Hello ' + name + '!')
}
module.exports = {
  sayHello: sayHello
}

在需要使用這些模組的檔案中,使用require(path)將公用程式碼引入。

var common = require('common.js')
Page({
  helloMINA: function() {
    common.sayHello('MINA')
  }
})

ES6 語法以及API 支援

微信小程式運行在三端:iOS、Android 和用於偵錯的開發者工具

  • 在iOS 上,小程式的javascript 程式碼是在JavaScriptCore 中執行
  • 在Android 上,小程式的javascript 程式碼是透過X5 核心來解析
  • 在開發工具上,小程式的javascript 程式碼運行在nwjs(chrome核心) 中

雖然儘管三端的環境是十分相似的,但是至少在目前還是有一些區別的,這給很多開發者帶來很大的困擾。

在0.10.101000 以及之後版本的開發工具中,會預設使用 babel 將開發者程式碼 ES6 語法轉換為三端都能很好支援的 ES5 的程式碼,幫助開發者解決環境不同所帶來的開發問題。開發者可以在專案設定中關閉這個功能。

要注意的是:

  • 這個轉換只會幫助開發處理語法上問題,新的 ES6 的API 例如 Promise 等需要開發者自行引入 Polyfill 或別的類庫。
  • 為了提升程式碼品質,在開啟 ES6 轉換功能的情況下,預設啟用 javasctipt 嚴格模式,請參考 "use strict" 。