前言

AngularJS易于開(kāi)發(fā)、較多的特征及較好的效果導(dǎo)致了較多的應(yīng)用，伴隨而來(lái)的是一些陷阱。本文列舉了AngularJS的一些共同的易于出問(wèn)題的地方，下面來(lái)一起看看吧。

一、MVC目錄結(jié)構(gòu)

AngularJS，直白地說(shuō)，就是一個(gè)MVC框架。它的模型并沒(méi)有像backbone.js框架那樣定義的如此明確，但它的體系結(jié)構(gòu)卻恰如其分。當(dāng)你工作于一個(gè)MVC框架時(shí)，普遍的做法是根據(jù)文件類(lèi)型對(duì)其進(jìn)行歸類(lèi)：

templates/
 _login.html
 _feed.html
app/
 app.js
 controllers/
 LoginController.js
 FeedController.js
 directives/
 FeedEntryDirective.js
 services/
 LoginService.js
 FeedService.js
 filters/
 CapatalizeFilter.js

看起來(lái)，這似乎是一個(gè)顯而易見(jiàn)的結(jié)構(gòu)，更何況Rails也是這么干的。然而一旦app規(guī)模開(kāi)始擴(kuò)張，這種結(jié)構(gòu)會(huì)導(dǎo)致你一次需要打開(kāi)很多目錄，無(wú)論你是使用sublime，Visual Studio或是Vim結(jié)合Nerd Tree，你都會(huì)投入很多時(shí)間在目錄樹(shù)中不斷地滑上滑下。

與按照類(lèi)型劃分文件不同，取而代之的，我們可以按照特性劃分文件：

app/
 app.js
 Feed/
 _feed.html
 FeedController.js
 FeedEntryDirective.js
 FeedService.js
 Login/
 _login.html
 LoginController.js
 LoginService.js
 Shared/
 CapatalizeFilter.js

這種目錄結(jié)構(gòu)使得我們能夠更容易地找到與某個(gè)特性相關(guān)的所有文件，繼而加快我們的開(kāi)發(fā)進(jìn)度。盡管將.html和.js文件置于一處可能存在爭(zhēng)議，但節(jié)省下來(lái)的時(shí)間更有價(jià)值。

二、模塊

將所有東西都一股腦放在主模塊下是很常見(jiàn)的，對(duì)于小型app，剛開(kāi)始并沒(méi)有什么問(wèn)題，然而很快你就會(huì)發(fā)現(xiàn)坑爹的事來(lái)了。

var app = angular.module('app',[]);
app.service('MyService', function(){
 //service code
});
app.controller('MyCtrl', function($scope, MyService){
 //controller code
});

在此之后，一個(gè)常見(jiàn)的策略是對(duì)相同類(lèi)型的對(duì)象歸類(lèi)。

var services = angular.module('services',[]);
services.service('MyService', function(){
 //service code
});
 
var controllers = angular.module('controllers',['services']);
controllers.controller('MyCtrl', function($scope, MyService){
 //controller code
});
 
var app = angular.module('app',['controllers', 'services']);

這種方式和前面第一部分所談到的目錄結(jié)構(gòu)差不多：不夠好。根據(jù)相同的理念，可以按照特性歸類(lèi)，這會(huì)帶來(lái)可擴(kuò)展性。

var sharedServicesModule = angular.module('sharedServices',[]);
sharedServices.service('NetworkService', function($http){});
 
var loginModule = angular.module('login',['sharedServices']);
loginModule.service('loginService', function(NetworkService){});
loginModule.controller('loginCtrl', function($scope, loginService){});
 
var app = angular.module('app', ['sharedServices', 'login']);

當(dāng)我們開(kāi)發(fā)一個(gè)大型應(yīng)用程序時(shí)，可能并不是所有東西都包含在一個(gè)頁(yè)面上。將同一類(lèi)特性置于一個(gè)模塊內(nèi)，能使跨app間重用模塊變得更容易。

三、依賴(lài)注入

依賴(lài)注入是AngularJS最好的模式之一，它使得測(cè)試更為簡(jiǎn)單，并且依賴(lài)任何指定對(duì)象都很明確。AngularJS的注入方式非常靈活，最簡(jiǎn)單的方式只需要將依賴(lài)的名字傳入模塊的function中即可：

var app = angular.module('app',[]);
 
app.controller('MainCtrl', function($scope, $timeout){
 $timeout(function(){
 console.log($scope);
 }, 1000);
});

這里，很明顯，MainCtrl依賴(lài)$scope和$timeout 。

直到你準(zhǔn)備將其部署到生產(chǎn)環(huán)境并希望精簡(jiǎn)代碼時(shí)，一切都很美好。如果使用UglifyJS，之前的例子會(huì)變成下面這樣：

var app=angular.module("app",[]);
app.controller("MainCtrl",function(e,t){t(function(){console.log(e)},1e3)})

現(xiàn)在AngularJS怎么知道MainCtrl依賴(lài)誰(shuí)？AngularJS提供了一種非常簡(jiǎn)單的解決方法，即將依賴(lài)作為一個(gè)數(shù)組傳入，數(shù)組的最后一個(gè)元素是一個(gè)函數(shù)，所有的依賴(lài)項(xiàng)作為它的參數(shù)。

app.controller('MainCtrl', ['$scope', '$timeout', function($scope, $timeout){
 $timeout(function(){
 console.log($scope);
 }, 1000);
}]);

這樣做能夠精簡(jiǎn)代碼，并且AngularJS知道如何解釋這些明確的依賴(lài)：

app.controller("MainCtrl",["$scope","$timeout",function(e,t){t(function(){console.log(e)},1e3)}])

3.1 全局依賴(lài)

在編寫(xiě)AngularJS程序時(shí)，時(shí)常會(huì)出現(xiàn)這種情況：某個(gè)對(duì)象有一個(gè)依賴(lài)，而這個(gè)對(duì)象又將其自身綁定在全局scope上，這意味著在任何AngularJS代碼中這個(gè)依賴(lài)都是可用的，但這卻破壞了依賴(lài)注入模型，并會(huì)導(dǎo)致一些問(wèn)題，尤其體現(xiàn)在測(cè)試過(guò)程中。

使用AngularJS可以很容易的將這些全局依賴(lài)封裝進(jìn)模塊中，所以它們可以像AngularJS標(biāo)準(zhǔn)模塊那樣被注入進(jìn)去。

Underscrore.js是一個(gè)很贊的庫(kù)，它可以以函數(shù)式的風(fēng)格簡(jiǎn)化Javascript代碼，通過(guò)以下方式，你可以將其轉(zhuǎn)化為一個(gè)模塊：

var underscore = angular.module('underscore', []);
underscore.factory('_', function() {
 return window._; //Underscore must already be loaded on the page
});
var app = angular.module('app', ['underscore']);
 
app.controller('MainCtrl', ['$scope', '_', function($scope, _) {
 init = function() {
  _.keys($scope);
 }
 
 init();
}]);

這樣的做法允許應(yīng)用程序繼續(xù)以AngularJS依賴(lài)注入的風(fēng)格進(jìn)行開(kāi)發(fā)，同時(shí)在測(cè)試階段也能將underscore交換出去。

這可能看上去十分瑣碎，沒(méi)什么必要，但如果你的代碼中正在使用use strict（而且必須使用），那這就是必要的了。

四、控制器膨脹

控制器是AngularJS的肉和土豆，一不小心就會(huì)將過(guò)多的邏輯加入其中，尤其是剛開(kāi)始的時(shí)候。控制器永遠(yuǎn)都不應(yīng)該去操作DOM，或是持有DOM選擇器，那是我們需要使用指令和ng-model的地方。同樣的，業(yè)務(wù)邏輯應(yīng)該存在于服務(wù)中，而非控制器。

數(shù)據(jù)也應(yīng)該存儲(chǔ)在服務(wù)中，除非它們已經(jīng)被綁定在$scope上了。服務(wù)本身是單例的，在應(yīng)用程序的整個(gè)生命周期都存在，然而控制器在應(yīng)用程序的各狀態(tài)間是瞬態(tài)的。如果數(shù)據(jù)被保存在控制器中，當(dāng)它被再次實(shí)例化時(shí)就需要重新從某處獲取數(shù)據(jù)。即使將數(shù)據(jù)存儲(chǔ)于localStorage中，檢索的速度也要比Javascript變量慢一個(gè)數(shù)量級(jí)。

AngularJS在遵循單一職責(zé)原則（SRP）時(shí)運(yùn)行良好，如果控制器是視圖和模型間的協(xié)調(diào)者，那么它所包含的邏輯就應(yīng)該盡量少，這同樣會(huì)給測(cè)試帶來(lái)便利。

五、Service vs Factory

幾乎每一個(gè)AngularJS開(kāi)發(fā)人員在初學(xué)時(shí)都會(huì)被這些名詞所困擾，這真的不太應(yīng)該，因?yàn)樗鼈兙褪轻槍?duì)幾乎相同事物的語(yǔ)法糖而已！

以下是它們?cè)贏ngularJS源代碼中的定義：

function factory(name, factoryFn) { 
 return provider(name, { $get: factoryFn }); 
}
 
function service(name, constructor) {
 return factory(name, ['$injector', function($injector) {
 return $injector.instantiate(constructor);
 }]);
}

從源代碼中你可以看到，service僅僅是調(diào)用了factory函數(shù)，而后者又調(diào)用了provider函數(shù)。事實(shí)上，AngularJS也為一些值、常量和裝飾提供額外的provider封裝，而這些并沒(méi)有導(dǎo)致類(lèi)似的困惑，它們的文檔都非常清晰。

由于service僅僅是調(diào)用了factory函數(shù)，這有什么區(qū)別呢？線索在$injector.instantiate：在這個(gè)函數(shù)中，$injector在service的構(gòu)造函數(shù)中創(chuàng)建了一個(gè)新的實(shí)例。

以下是一個(gè)例子，展示了一個(gè)service和一個(gè)factory如何完成相同的事情：

var app = angular.module('app',[]);
 
app.service('helloWorldService', function(){
 this.hello = function() {
 return "Hello World";
 };
});
 
app.factory('helloWorldFactory', function(){
 return {
 hello: function() {
  return "Hello World";
 }
 }
});

當(dāng)helloWorldService或helloWorldFactory被注入到控制器中，它們都有一個(gè)hello方法，返回”hello world”。service的構(gòu)造函數(shù)在聲明時(shí)被實(shí)例化了一次，同時(shí)factory對(duì)象在每一次被注入時(shí)傳遞，但是仍然只有一個(gè)factory實(shí)例。所有的providers都是單例。

既然能做相同的事，為什么需要兩種不同的風(fēng)格呢？相對(duì)于service，factory提供了更多的靈活性，因?yàn)樗梢苑祷睾瘮?shù)，這些函數(shù)之后可以被新建出來(lái)。這迎合了面向?qū)ο缶幊讨泄S模式的概念，工廠可以是一個(gè)能夠創(chuàng)建其他對(duì)象的對(duì)象。

app.factory('helloFactory', function() {
 return function(name) {
 this.name = name;
 
 this.hello = function() {
  return "Hello " + this.name;
 };
 };
});

這里是一個(gè)控制器示例，使用了service和兩個(gè)factory，helloFactory返回了一個(gè)函數(shù)，當(dāng)新建對(duì)象時(shí)會(huì)設(shè)置name的值。

app.controller('helloCtrl', function($scope, helloWorldService, helloWorldFactory, helloFactory) {
 init = function() {
 helloWorldService.hello(); //'Hello World'
 helloWorldFactory.hello(); //'Hello World'
 new helloFactory('Readers').hello() //'Hello Readers'
 }
 
 init();
});

在初學(xué)時(shí)，最好只使用service。

Factory在設(shè)計(jì)一個(gè)包含很多私有方法的類(lèi)時(shí)也很有用：

app.factory('privateFactory', function(){
 var privateFunc = function(name) {
 return name.split("").reverse().join(""); //reverses the name
 };
 
 return {
 hello: function(name){
  return "Hello " + privateFunc(name);
 }
 };
});

通過(guò)這個(gè)例子，我們可以讓privateFactory的公有API無(wú)法訪問(wèn)到privateFunc方法，這種模式在service中是可以做到的，但在factory中更容易。

六、沒(méi)有使用Batarang

Batarang是一個(gè)出色的Chrome插件，用來(lái)開(kāi)發(fā)和測(cè)試AngularJS app。

Batarang提供了瀏覽模型的能力，這使得我們有能力觀察AngularJS內(nèi)部是如何確定綁定到作用域上的模型的，這在處理指令以及隔離一定范圍觀察綁定值時(shí)非常有用。

Batarang也提供了一個(gè)依賴(lài)圖， 如果我們正在接觸一個(gè)未經(jīng)測(cè)試的代碼庫(kù)，這個(gè)依賴(lài)圖就很有用，它能決定哪些服務(wù)應(yīng)該被重點(diǎn)關(guān)照。

最后，Batarang提供了性能分析。Angular能做到開(kāi)包即用，性能良好，然而對(duì)于一個(gè)充滿(mǎn)了自定義指令和復(fù)雜邏輯的應(yīng)用而言，有時(shí)候就不那么流暢了。使用Batarang性能工具，能夠直接觀察到在一個(gè)digest周期中哪個(gè)函數(shù)運(yùn)行了最長(zhǎng)時(shí)間。性能工具也能展示一棵完整的watch樹(shù)，在我們擁有很多watcher時(shí)，這很有用。

七、過(guò)多的watcher

在上一點(diǎn)中我們提到，AngularJS能做到開(kāi)包即用，性能良好。由于需要在一個(gè)digest周期中完成臟數(shù)據(jù)檢查，一旦watcher的數(shù)量增長(zhǎng)到大約2000時(shí)，這個(gè)周期就會(huì)產(chǎn)生顯著的性能問(wèn)題。（2000這個(gè)數(shù)字不能說(shuō)一定會(huì)造成性能大幅下降，但這是一個(gè)不錯(cuò)的經(jīng)驗(yàn)數(shù)值。在AngularJS 1.3 release版本中，已經(jīng)有一些允許嚴(yán)格控制digest周期的改動(dòng)了。）

以下這個(gè)“立即執(zhí)行的函數(shù)表達(dá)式(IIFE)”會(huì)打印出當(dāng)前頁(yè)面上所有的watcher的個(gè)數(shù)，你可以簡(jiǎn)單的將其粘貼到控制臺(tái)中，觀察結(jié)果。這段IIFE來(lái)源于Jared在StackOverflow上的回答：

(function () { 
 var root = $(document.getElementsByTagName('body'));
 var watchers = [];
 
 var f = function (element) {
 if (element.data().hasOwnProperty('$scope')) {
  angular.forEach(element.data().$scope.$$watchers, function (watcher) {
  watchers.push(watcher);
  });
 }
 
 angular.forEach(element.children(), function (childElement) {
  f($(childElement));
 });
 };
 
 f(root);
 
 console.log(watchers.length);
})();

通過(guò)這個(gè)方式得到watcher的數(shù)量，結(jié)合Batarang性能板塊中的watch樹(shù)，應(yīng)該可以看到哪里存在重復(fù)代碼，或著哪里存在不變數(shù)據(jù)同時(shí)擁有watch。

當(dāng)存在不變數(shù)據(jù)，而你又想用AngularJS將其模版化，可以考慮使用bindonce。Bindonce是一個(gè)簡(jiǎn)單的指令，允許你使用AngularJS中的模版，但它并不會(huì)加入watch，這就保證了watch數(shù)量不會(huì)增長(zhǎng)。

八、限定$scope的范圍

Javascript基于原型的繼承與面向?qū)ο笾谢陬?lèi)的繼承有著微妙的區(qū)別，這通常不是什么問(wèn)題，但這個(gè)微妙之處在使用$scope時(shí)就會(huì)表現(xiàn)出來(lái)。在AngularJS中，每個(gè)$scope都會(huì)繼承父$scope，最高層稱(chēng)之為$rootScope。（$scope與傳統(tǒng)指令有些不同，它們有一定的作用范圍i，且只繼承顯式聲明的屬性。）

由于原型繼承的特點(diǎn)，在父類(lèi)和子類(lèi)間共享數(shù)據(jù)不太重要，不過(guò)如果不小心的話，也很容易誤用了一個(gè)父$scope的屬性。

比如說(shuō)，我們需要在一個(gè)導(dǎo)航欄上顯示一個(gè)用戶(hù)名，這個(gè)用戶(hù)名是在登錄表單中輸入的，下面這種嘗試應(yīng)該是能工作的：

<div ng-controller="navCtrl">
 <span>{{user}}</span>
 <div ng-controller="loginCtrl">
 <span>{{user}}</span>
 <input ng-model="user"></input>
 </div>
</div>

那么問(wèn)題來(lái)了……：在text input中設(shè)置了user的ng-model，當(dāng)用戶(hù)在其中輸入內(nèi)容時(shí)，哪個(gè)模版會(huì)被更新？navCtrl還是loginCtrl，還是都會(huì)？

如果你選擇了loginCtrl，那么你可能已經(jīng)理解了原型繼承是如何工作的了。

當(dāng)你檢索字面值時(shí)，原型鏈并不起作用。如果navCtrl也同時(shí)被更新的話，檢索原型鏈?zhǔn)潜仨毜模?strong>但如果值是一個(gè)對(duì)象，這就會(huì)發(fā)生。（記住，在Javascript中，函數(shù)、數(shù)組和對(duì)象都是對(duì)象）

所以為了獲得預(yù)期的行為，需要在navCtrl中創(chuàng)建一個(gè)對(duì)象，它可以被loginCtrl引用。

<div ng-controller="navCtrl">
 <span>{{user.name}}</span>
 <div ng-controller="loginCtrl">
 <span>{{user.name}}</span>
 <input ng-model="user.name"></input>
 </div>
</div>

現(xiàn)在，由于user是一個(gè)對(duì)象，原型鏈就會(huì)起作用，navCtrl模版和$scope和loginCtrl都會(huì)被更新。

這看上去是一個(gè)很做作的例子，但是當(dāng)你使用某些指令去創(chuàng)建子$scope，如ngRepeat時(shí)，這個(gè)問(wèn)題很容易就會(huì)產(chǎn)生。

九、手工測(cè)試

由于TDD可能不是每個(gè)開(kāi)發(fā)人員都喜歡的開(kāi)發(fā)方式，因此當(dāng)開(kāi)發(fā)人員檢查代碼是否工作或是否影響了其它東西時(shí)，他們會(huì)做手工測(cè)試。

不去測(cè)試AngularJS app，這是沒(méi)有道理的。AngularJS的設(shè)計(jì)使得它從頭到底都是可測(cè)試的，依賴(lài)注入和ngMock模塊就是明證。AngularJS核心團(tuán)隊(duì)已經(jīng)開(kāi)發(fā)了眾多能夠使測(cè)試更上一層樓的工具。

9.1 Protractor

單元測(cè)試是一個(gè)測(cè)試工作的基礎(chǔ)，但考慮到app的日益復(fù)雜，集成測(cè)試更貼近實(shí)際情況。幸運(yùn)的是，AngularJS的核心團(tuán)隊(duì)已經(jīng)提供了必要的工具。

我們已經(jīng)建立了Protractor，一個(gè)端到端的測(cè)試器用以模擬用戶(hù)交互，這能夠幫助你驗(yàn)證你的AngularJS程序的健康狀況。

Protractor使用Jasmine測(cè)試框架定義測(cè)試，Protractor針對(duì)不同的頁(yè)面交互行為有一個(gè)非常健壯的API。

我們還有一些其他的端到端測(cè)試工具，但是Protractor的優(yōu)勢(shì)是它能夠理解如何與AngularJS代碼協(xié)同工作，尤其是在$digest周期中。

9.2 Karma

一旦我們用Protractor完成了集成測(cè)試的編寫(xiě)工作，接下去就是執(zhí)行測(cè)試了。等待測(cè)試執(zhí)行，尤其是集成測(cè)試，對(duì)每個(gè)開(kāi)發(fā)人員都是一種淡淡的憂傷。AngularJS的核心團(tuán)隊(duì)也感到極為蛋疼，于是他們開(kāi)發(fā)了Karma。

Karma是一個(gè)測(cè)試器，它有助于關(guān)閉反饋回路。Karma之所以能夠做到這點(diǎn)，是因?yàn)樗谥付ㄎ募桓淖儠r(shí)就運(yùn)行測(cè)試。Karma同時(shí)也會(huì)在多個(gè)瀏覽器上運(yùn)行測(cè)試，不同的設(shè)備也可以指向Karma服務(wù)器，這樣就能夠更好地覆蓋真實(shí)世界的應(yīng)用場(chǎng)景。

十、使用jQuery

jQuery是一個(gè)酷炫的庫(kù)，它有標(biāo)準(zhǔn)化的跨平臺(tái)開(kāi)發(fā)，幾乎已經(jīng)成為了現(xiàn)代化Web開(kāi)發(fā)的必需品。不過(guò)盡管JQuery如此多的優(yōu)秀特性，它的理念和AngularJS并不一致。

AngularJS是一個(gè)用來(lái)建立app的框架，而JQuery則是一個(gè)簡(jiǎn)化“HTML文檔操作、事件處理、動(dòng)畫(huà)和Ajax”的庫(kù)。這是兩者最基本的區(qū)別，AngularJS致力于程序的體系結(jié)構(gòu)，與HTML頁(yè)面無(wú)關(guān)。

為了更好的理解如何建立一個(gè)AngularJS程序，請(qǐng)停止使用jQuery。JQuery使開(kāi)發(fā)人員以現(xiàn)存的HTML標(biāo)準(zhǔn)思考問(wèn)題，但正如文檔里所說(shuō)的，“AngularJS能夠讓你在應(yīng)用程序中擴(kuò)張HTML這個(gè)詞匯”。

DOM操作應(yīng)該只在指令中完成，但這并不意味著他們只能用JQuery封裝。在你使用JQuery之前，你應(yīng)該總是去想一下這個(gè)功能是不是AngularJS已經(jīng)提供了。當(dāng)指令互相依賴(lài)時(shí)能夠創(chuàng)建強(qiáng)大的工具，這確實(shí)很強(qiáng)大。

但一個(gè)非常棒的JQuery是必需品時(shí)，這一天可能會(huì)到來(lái)，但在一開(kāi)始就引入它，是一個(gè)常見(jiàn)的錯(cuò)誤。

總結(jié)

AngularJS是一卓越的框架，在社區(qū)的幫助下始終在進(jìn)步。雖說(shuō)AngularJS仍然是一個(gè)不斷發(fā)展的概念，但我希望人們能夠遵循以上談到的這些約定，避免開(kāi)發(fā)AngularJS應(yīng)用所遇到的那些問(wèn)題。希望這篇文章的內(nèi)容對(duì)大家能有有所幫助，如果有問(wèn)題可以留言交流，謝謝大家對(duì)腳本之家的支持。