《深刻淺出React和Redux》(4) - 服務器通訊、單元測試

與服務器通訊

與服務器通訊的時長不可控，須要採用異步的形式，可使用js的fetch函數來調用api。

fetch函數

fetch函數的基本使用形式爲：

fetch(apiUrl).then((response) => {
  if (response.status !== 200) {
    throw new Error('Fail to get response with status ' + response.status);
  }

  response.json().then((responseJson) => {
    this.setState(...);
  }).catch((error) => {
    this.setState(...);
  });
}).catch((error) => {
  this.setState(...);
});

以純react（沒有引入redux）的代碼爲例，fetch函數執行時會當即返回一個Promise類型的對象，因此要接then和catch，只要服務器返回的是合法的HTTP響應（包括500、400），都會觸發then調用，因此在then回調函數中還須要判斷status是否爲200。
此外，即便在response.status爲200時，也不能直接讀取response中的內容，由於fetch在接收到HTTP響應的報頭部分就會調用then，而不是等到整個HTTP響應完成。因此爲了獲取到body，還須要繼續調用json()並針對其返回的Promise提供回調函數。
在終於成功獲取到服務器返回的內容後，經過觸發狀態的變化引起頁面的從新渲染。

redux-thunk中間件

redux的單向數據流是同步操做，如何實現調用服務器這樣的異步操做呢？可使用redux-thunk中間件。

npm install --save redux-thunk

在Redux架構下，一個action對象在經過store.dispatch派發，在調用reducer函數以前，會先通過一箇中間件的環節，這就是產生異步操做的機會。

要產生異步操做要發送異步action對象，與普通的action對象不一樣，它並無type字段，並且它是一個函數。而redux-thunk的工做是檢查action對象是否是函數，若是不是函數就放行，完成普通action對象的生命週期，而若是發現action對象是函數，那就執行這個函數，並把Store的dispatch函數和getState函數做爲參數傳遞到函數中去，處理過程到此爲止，不會讓這個異步action對象繼續往前派發到reducer函數。
createStore時，將redux-thunk中間件做爲storeEnhancer之一傳入：

const middlewares = [thunkMiddleware];

const storeEnhancers = compose(
  applyMiddleware(...middlewares),
  (win && win.devToolsExtension) ? win.devToolsExtension() : (f) => f,
);

export default createStore(reducer, {}, storeEnhancers);

異步操做有固定的模式，首先定義三種action類型，分別表示異步操做開始、成功、失敗：

export const FETCH_STARTED = 'WEATHER/FENTCH_STARTED';
export const FETCH_SUCCESS = 'WEATHER/FENTCH_SUCCESS';
export const FETCH_FAILURE = 'WEATHER/FENTCH_FAILURE';

而後定義生成異步action的函數，這個函數會被redux-thunk截獲並調用，調用時傳遞的參數是dispatch函數和getState函數：

export const sampleAsyncAction = ()=>{
  return (dispatch, getState) => {
    
    // 在這裏dispatch FETCH_STARTED action

    return fetch(apiUrl).then((response) => {
      if (response.status !== 200) {
        throw new Error('Fail to get response with status ' + response.status);
      }

      response.json().then((responseJson) => {
        // 在這裏dispatch FETCH_SUCCESS action
      }).catch((error) => {
        
      });
    }).catch((error) => {
        // 在這裏dispatch FETCH_FAILURE action
    });
  }
}

終止異步操做

在頁面與服務端交互過程當中，每每會有一次請求還沒結束就發出下一次請求的狀況，好比在選擇一個下拉項後調用API加載數據，若是數據還沒加載完成，就切換到別的下拉項，會發生什麼，這取決於兩次請求的返回順序，若是第一次請求先返回，那麼頁面會先顯示第一次的響應結果，再刷新爲第二次的，總體來講問題不大；可是若是第二次的請求先於第一次的返回，那麼頁面顯示的最終結果就與下拉項不匹配了。
對於這種場景，簡單點能夠經過加載數據時禁用下拉框來解決，但這種作法的用戶體驗較差，若是服務端一直沒有響應，下拉框就一直處於禁用狀態；還有更合理的一種作法時，在發出下一次API請求時，終止上一次的API請求。

惋惜ES6的標準中，Promise對象是沒法中斷的，爲此能夠經過應用層的修改來丟棄上一次的請求。以fetchWeather異步action舉例：

export const fetchWeather = (cityCode) => {
    return (dispatch) => {
        const seqId=++nextSeqId;

        const dispatchIfValid=(action)=>{
            if(seqId===nextSeqId){
                return dispatch(action);
            }
        }

        dispatchIfValid(fetchWeatherStarted());

        const apiUrl = `/data/cityinfo/${cityCode}.html`;

        // dispatch(fetchWeatherStarted());

        return fetch(apiUrl).then((response) => {
            if (response.status !== 200) {
                throw new Error('Fail to get response with status ' + response)
            }
            response.json().then((response) => {
                dispatchIfValid(fetchWeatherSuccess(response.weatherinfo));
            }).catch((error) => {
                throw new Error('Invalid js on response: ' + error);
            });
        }).catch((error) => {
            dispatchIfValid(fetchWeatherFailure(error));
        });
    }
};

在action構造函數文件中定義一個文件模塊級的nextSeqId變量，這是一個遞增的整數數字，給每個訪問API的請求作序列編號。在fetchWeather返回的函數中，fetch開始一個異步請求以前，先給nextSeqId自增長一，而後自增的結果賦值給一個局部變量seqId，這個seqId的值就是這一次異步請求的編號，若是隨後還有fetchWeather構造器被調用，那麼nextSeqId也會自增，新的異步請求會分配爲新的seqId。

而後，action構造函數中全部的dispatch函數都被替換爲一個新定義的函數dispatchIfValid，這個dispatchIfValid函數會檢查當前環境的seqId是否等同於全局的nextSeqId。若是相同，說明fetchWeather沒有被再次調用，就繼續使用dispatch函數。若是不相同，說明這期間有新的fetchWeather被調用，也就是有新的訪問服務器的請求被髮出去了，這時候當前seqId表明的請求就已通過時了，直接丟棄掉，不須要dispatch任何action。

單元測試

關於單元測試框架的選擇，因爲在create-react-app建立的應用中已經自帶了Jest庫，因此就直接使用Jest。
Jest會自動在當前目錄下尋找文件名以.test.js爲後綴的文件和存放在__test__目錄下的代碼文件，來執行單元測試。
單元測試代碼的組織方式，一般有兩種模式：

• 把所有測試代碼放在與src平行的test目錄，在test目錄下創建和src對應子目錄結構，每一個單元測試文件都加上test.js後綴，這種方法能夠保持src目錄的整潔，但缺點是單元測試中引用功能代碼的路徑會比較長；
• 在src的子目錄下建立__test__目錄，用於存放對應這個目錄的單元測試，這種方法的優缺點與第一種相反。

React & Redux 應用的測試對象主要有action構造函數、reducer、view，其中reducer、普通的action構造函數都是純函數，很是便於測試。
但異步action的構造函數和view的測試相對比較複雜。

異步action的構造函數的測試

一個異步action對象就是一個函數，須要結合redux-thunk之類的中間件才能發揮做用，異步action被派發以後，會連續派發另外兩個action對象表明fetch開始和fetch結束，單元測試要作的就是驗證這樣的行爲。
中間件的應用和action的dispatch都涉及到Redux Store，但單元測試中並不須要建立一個完整功能的Store，也不該該進行真實的網絡訪問。因此須要一些測試輔助工具。
其中可使用redux-mock-store來建立一個mock store：

npm install -save-dev redux-mock-store

使用sinon來「篡改」fetch函數的行爲，使其不會發出真實的網絡請求：

npm install -save-dev sinon

而後就能夠開始測試了，首先須要作一些準備工做：

Create Mock Store

import thunk from 'redux-thunk';
import configureStore from 'redux-mock-store';
const middlewares = [thunk];
const createMockStore = configureStore(middlewares);
...
const store = createMockStore();

Create Mock Store後，就能夠像真實store同樣在其上dispatch action了。

「篡改」fetch函數的行爲

import { stub } from 'sinon';
...
let stubbedFetch;

beforeEach(() => {
  stubbedFetch = stub(global, 'fetch');
});

afterEach(() => {
  stubbedFetch.restore();
});

const mockResponse = Promise.resolve({
  status: 200,
  json: () => Promise.resolve({
    weatherinfo: {}
  })
});
stubbedFetch.returns(mockResponse);

使用sinon的stub函數來覆蓋fetch的返回結果，單元測試用例之間應該互不影響，因此stubbedFetch應該在beforeEach中執行，並在測試用例跑完時執行afterEach時恢復stub行爲。

React組件的測試

測試React組件，測試的是渲染結果、事件處理。
但並非全部的測試過程都須要把React組件的DOM樹都渲染出來，尤爲對於包含複雜子組件的React組件，若是深刻渲染整個DOM樹，那就要渲染全部子組件，但是子組件可能會有其餘依賴關係，好比依賴於某個React Context值，爲了渲染這樣的子組件須要耗費不少精力準備測試環境，這種狀況下針對目標組件的測試只要讓它渲染頂層組件就行了，不須要測試子組件。
測試React組件能夠藉助Enzyme，它由AirBnb開源，enzyme依賴react-addons-test-utils，要一塊兒安裝：

npm install -save-dev enzyme react-addons-test-utils

Enzyme支持三種渲染方法：

• shallow，只渲染頂層React組件，不渲染子組件，適合只測試React組件的渲染行爲；
• mount，渲染完整的React組件包括子組件，藉助模擬的瀏覽器環境完成事件處理功能；
• render，渲染完整的React組件，可是隻產生HTML，並不進行事件處理。

無狀態React組件的測試，可使用shallow方法只渲染一層，忽略子組件是爲了簡化測試過程。舉例：

const wrapper = shallow(<Filter />);
expect(wrapper.contains(<Link filter={FilterTypes.ALL}> {FilterTypes.ALL} </Link>)).toBe(true);

被鏈接的React組件的測試，被鏈接的React組件是指狀態保存在Redux的Store上，並經過connect函數產生的組件，這種組件使用時須要包裹在Provider中，測試的時候也同樣，並且還會測試事件處理、action dispatch後引起視圖的變化，因此這裏須要使用真實的store。

import { Provider } from 'react-redux';
...

const subject = (
  <Provider store={store}>
    <待測組件 />
  </Provider>);

參考書籍

《深刻淺出React和Redux》 程墨