From 6312e38a633fd876995dcbeaeb359e4ad2369f6e Mon Sep 17 00:00:00 2001
From: Zhicheng Wang <zcwang@thoughtworks.com>
Date: Sun, 2 Sep 2018 19:31:59 +0800
Subject: [PATCH] =?UTF-8?q?docs(API):=20=E7=BF=BB=E8=AF=91=E5=AE=8C?=
 =?UTF-8?q?=E4=BA=86=20HttpHeaders?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 aio/content/translations/cn/api-plan.md |  2 +-
 packages/common/http/src/headers.ts     | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/aio/content/translations/cn/api-plan.md b/aio/content/translations/cn/api-plan.md
index 60f3bc9a77..6b41933388 100644
--- a/aio/content/translations/cn/api-plan.md
+++ b/aio/content/translations/cn/api-plan.md
@@ -35,7 +35,7 @@
 [x]  | common/NgStyle  | 0.60
 [x]  | router/RouterOutlet  | 0.59
 [x]  | forms/Validators  | 0.59
-[ ]  | common/http/HttpHeaders  | 0.56
+[x]  | common/http/HttpHeaders  | 0.56
 [x]  | core/Pipe  | 0.52
 [ ]  | common/NgSwitch  | 0.52
 [ ]  | forms/NgForm  | 0.50
diff --git a/packages/common/http/src/headers.ts b/packages/common/http/src/headers.ts
index a4c39e4f21..f688e89e01 100755
--- a/packages/common/http/src/headers.ts
+++ b/packages/common/http/src/headers.ts
@@ -15,10 +15,14 @@ interface Update {
 /**
  * Immutable set of Http headers, with lazy parsing.
  *
+ * Http 头的不可变集合，惰性解析。
+ *
  */
 export class HttpHeaders {
   /**
    * Internal map of lowercase header names to values.
+   *
+   * 一个内部映射表，key 是头名称的小写形式，value 是其值。
    */
   // TODO(issue/24571): remove '!'.
   private headers !: Map<string, string[]>;
@@ -27,17 +31,23 @@ export class HttpHeaders {
   /**
    * Internal map of lowercased header names to the normalized
    * form of the name (the form seen first).
+   *
+   * 一个内部映射表，key 是头名称的小写形式，值是该名称的标准化形式（即首先看到的形式）。
    */
   private normalizedNames: Map<string, string> = new Map();
 
   /**
    * Complete the lazy initialization of this object (needed before reading).
+   *
+   * 完成该对象的惰性初始化（在读取之前需要）。
    */
   // TODO(issue/24571): remove '!'.
   private lazyInit !: HttpHeaders | Function | null;
 
   /**
    * Queued updates to be materialized the next initialization.
+   *
+   * 一个队列，用于存储下次初始化时要执行的更新。
    */
   private lazyUpdate: Update[]|null = null;
 
@@ -82,6 +92,8 @@ export class HttpHeaders {
 
   /**
    * Checks for existence of header by given name.
+   *
+   * 检查是否存在指定名称的头。
    */
   has(name: string): boolean {
     this.init();
@@ -91,6 +103,8 @@ export class HttpHeaders {
 
   /**
    * Returns first header that matches given name.
+   *
+   * 返回匹配指定名称的第一个头的值。
    */
   get(name: string): string|null {
     this.init();
@@ -101,6 +115,8 @@ export class HttpHeaders {
 
   /**
    * Returns the names of the headers
+   *
+   * 返回头中所有的名称。
    */
   keys(): string[] {
     this.init();
@@ -110,6 +126,8 @@ export class HttpHeaders {
 
   /**
    * Returns list of header values for a given name.
+   *
+   * 返回头中具有指定名称的值的列表。
    */
   getAll(name: string): string[]|null {
     this.init();