---
title: Internationalization (i18n) Testing
tags: Chinese
---
# 多國語言測試
本文將介紹如何使用SideeX錄製一次測試案例後，搭配多國語言檔以進行多國語言測試。

## 步驟1：設定WebDriver
多國語言測試需透過WebDriver才能執行

- 若使用SideeX Recorder進行多國語言測試，請參閱[透過WebDriver進行跨瀏覽器測試](/@sideex/webdriver-zh)進行WebDriver設定
- 若使用SideeX Runner進行多國語言測試，請參閱[SideeX Runner](/@sideex/runner-zh)進行WebDriver設定

:::warning
注意：目前僅支援透過**Chrome**與**Firefox**進行多國語言測試，請勿啟用其他瀏覽器
:::

## 步驟2：準備語言檔

語言檔須為JSON格式，結構如下。若已存在的語言檔非以下結構，則必須先行轉換。

{
  "ima": {
    "ge": "画像"
  },
  "user": ["佐藤", "鈴木", "高橋", "田中", "渡邊"]
}

Name-Value的配對可為巢狀結構，範例中的`ima.ge`即對應到`画像`。


## 步驟3：匯入語言檔
- 若使用SideeX Recorder，則於設定頁面中勾選欲測試的語言並匯入語言檔
然後啟用`Playback through WebDriver`與`Internationalization Testing with WebDriver`
- 若使用SideeX Runner，則參考[SideeX Runner](/@sideex/runner-zh)於設定檔中設定

## 步驟4：使用`@{I18N_VAR_NAME}`

在指令上使用`@{I18N_VAR_NAME}`格式來引入語言檔中的文字。在範例中，若要驗證Google首頁`Image`元素的文字是否在日語系瀏覽器能正確顯示`画像`，在此步驟中先將`verifyText`指令`Value`欄位值填入`@{ima.ge}`。
:::info
提示：語言檔中可使用陣列，在範例中`user`即為一個陣列`["佐藤", "鈴木", "高橋", "田中", "渡邊"]`，並且可使用`@{user.0}`、`@{user.1}`、`@{user.3}`與`@{user.4}`引用它們
:::

## 步驟5：播放測試案例
播放測試案例時，每個測試案例會針對每個設定的語言檔執行一次，同時瀏覽器亦會依據不同的語言開啟。如下圖所示，瀏覽器將開啟Google首頁，並且驗證`Image`元素的文字是否為`画像`。


播放結束時，將針對不同的語言產生不同的測試報告，每份報告中的Summary部分將顯示所測試的語言。