摘要：瀏覽器原生提供的幾個找到元素的方法為網頁全局唯一。匹配包含的元素匹配包含和的元素級聯用法和相似返回一個。以上返回數組的方法，返回的都是的。

那是個夜黑風高的夜晚，我遇到了一個按鈕：

搜索

嗯，我要選中它，我敲下了一行代碼：

const submitButton = document.querySelector("button[type="submit"]");

這對于精通 document.querySelector 的函數名書寫方式的我來說，簡直就像吃下四兩飯一樣簡單！

但是。

我們知道，document.querySelector 接收一個選擇器字符串，返回第一個匹配的 DOM 元素，所以如果頁面上只有一個 button[type="submit"] 或者這個 button[type="submit"] 在 html 中是第一個時，我這個方法是無懈可擊的。

然后，我發現頁面上竟然存在兩個 button[type="submit"] 類型的按鈕(黑人問號？？？)。

我對比了一下差異：

提交
搜索

先不八卦為什么頁面上有兩個差不多的按鈕，但能初步判定的是，他們長得很像，嗯。

那么，問題來了，我怎么選中那個搜索框，我把問題拋給了自以為是的自己，得到了幾個回答。

分身 A：改用 selectorSelectorAll 拿到第二個不就行了嘛！

const allSubmitButton = document.querySelectorAll("button[type="submit"]");
const submitButton = allSubmitButton[1];

這方法貌似不錯，但萬一這兩個按鈕對調位置了怎么辦？

分身 B: 那選擇器寫全一點，也匹配『搜索』這兩個字不就可以把『提交』那個按鈕給拍除掉了嘛！

const submitButton = document.querySelector("button[type="submit"][innerText="搜索"]");

打印出來一看，嗯，怎么輸出是 null？？？

分身 B: 那個，那個。。。innerText 是我編出來的，我不知道正確的要怎么寫。

嗯，雖然 B 寫錯了語法(哪個程序員會不寫錯語法？)，但限定了兩個條件，type="submit" 和 innerText="搜索", 能唯一匹配搜索按鈕了，這個思路是對的。

那么，正確的語法是什么呢？

苦苦搜索半天，無果。

分身 C: 那就是寫不出這樣的選擇器吧，還是用 JS 來做吧 ：）

分身 A: 這么簡單的需求，CSS 是萬能的，為什么要用 Javascript？

分身 B: 對，Hail CSS！

。。。那我們就借此機會溫習一下找到一個 DOM 元素有哪些方法吧。

Id 為網頁全局唯一。

document.getElementById("id");

注意，與其他方法不一樣，getElementById 只能被全局對象 document 調用，否則會報錯：

document.getElementById("parentId").getElementById("childId");
// Uncaught TypeError: document.getElementById(...).getElementById is not a function

因為 Id 是全局唯一的，所以上面第二種寫法自然也顯得沒有必要。

Id 對大小寫敏感(除非文檔被聲明為特殊類型如: XHTML, XUL)，所以以下兩種寫法并不等同：

document.getElementById("id");
documen.getElementById("ID");

這里的 element 指代網頁中有效的 DOM 元素，包含 document。

返回一個 HTMLCollection。

// 匹配 class 包含 "submit" 的元素
document.getElementsByClassName("submit");

// 匹配 class 包含 "submit" 和 "button" 的元素
document.getElementsByClassName("submit button");

// 級聯
cons selectedElement = document.getElementById("app-container");
selectedElement.getElementsByClassName("submit button");

用法和 getElementsByClassName 相似, 返回一個 HTMLCollection。

用法和 getElementsByClassName 相似, 返回一個 HTMLCollection。

再熟悉不過的接口了，傳入 CSS 選擇器，返回第一個找到的元素。

以上返回數組的方法，getElementsByName、getElementsByTagName、getElementsByTagNameNS、querySelectorAll 返回的都是 Array-like 的 HTMLCollection。

要像對數組一樣對 HTMLCollection 進行操作(使用數組的 forEach、filter 等方法)，則需要將他們轉化為數組:

const buttonCollection = document.getElementsByClassName("submit");

// const buttonArray = Array.prototype.slice.call(buttonCollection);
const buttonArray = [].slice.call(buttonCollection);

buttonArray.forEach(item => {
    // do something
});

注意，對于都是返回 HTMLCollection 的方法，與 querySelector 不同的是，getElementsByName、getElementsByClassName、getElementsByTagName 返回的 HTMLCollection 是一個引用類型的 HTMLCollection 。

也就是：

querySelectorAll 獲取的是當時文檔中匹配選擇器的 DOM 元素，不包含后面插入到文檔中的元素，如果文檔有更新，則需要重新獲取

而 getElementsByName、getElementsByClassName 和 getElementsByTagName 則能隨時反映文檔中匹配對應規則的元素，包含后面插入到文檔中的元素，如果文檔有更新，不需要重新獲取

這個說法有點類似拷貝和引用的關系。

話不多說，我們直接寫點代碼做個測試：

const createElement = (func) => {
    const key = "myCustomElement";
    let element;
    switch (func) {
        case "getElementsByName":
            element = document.createElement("div");
            element.setAttribute("name", key);
            break;
        case "getElementsByClassName":
            element = document.createElement("div");
            element.setAttribute("class", key);
            break;
        case "getElementsByTagName":
            element = document.createElement(key);
            break;
        case "querySelectorAll":
            element = document.createElement("div");
            element.className = key;
            break;
        default:
            element = document.createElement("div");
    }

    return element;
}

const getCollection = (root, func) => {
    const key = "myCustomElement";
    let element;
    if (func === "getElementsByName") {
        return document.getElementsByName(key);
    }
    if (func === "querySelectorAll") {
        return root.querySelectorAll(`.${key}`);
    }
    return root[func](key);
}


const testFunc = (func) => {
    const result = [];

    // 避免 getElementsByClassName 和 querySelectorAll 在統一環境的影響，創建一個獨立的容器測試
    const container = document.createElement("div");
    document.body.append(container);

    // 1. 插入一個
    container.append(createElement(func));

    // 2. 看下現在有多少個
    const collection = getCollection(container, func);
    result.push(collection.length);

    // 3. 繼續插入一個
    container.append(createElement(func));

    // 4. 看下現在有多少個
    result.push(collection.length);

    return result;
};

console.log("getElementsByName", testFunc("getElementsByName")); // [1, 2]
console.log("getElementsByClassName", testFunc("getElementsByClassName")); // [1, 2]
console.log("getElementsByTagName", testFunc("getElementsByTagName")); // [1, 2]
console.log("querySelectorAll", testFunc("querySelectorAll")); // [1, 1] // 注意這個輸出

// 輸出的是：
/*
    getElementsByName [1, 2]
    getElementsByClassName [1, 2]
    getElementsByTagName [1, 2]
    querySelectorAll [1, 1]
*/

回到本文討論的問題，貌似瀏覽器原生并沒有提供類似 document.getElementByInnerText ？

找了一圈貌似沒有，那只能借用 Javascript 了。

回憶一下需要找到的元素是：

搜索

可以使用 querySelectorAll ：

let foundElement = null;
const elementsCollection = document.querySelectorAll("button[type="submit"]");
const elementArray = [].slice.call(elementsCollection);
/*
// 使用 Array.forEach 遍歷，缺點是找到后沒法 break
elementArray.forEach(element => {
    if (element.innerText.trim() === "搜索") {
        foundElement = element;
    }

    // 或者使用正則
    /*
    if (/^s{0,}搜索s{0,}$/.test(element.innerText)) {
        foundElement = element;
    }
    */
});
*/

/*
// 或使用 for-loop 找到后提前 break
const len = inputElementArray.length;
for (let i = 0; i < len; i++) {
    if (elementArray[i].innerText.trim()) {
        foundElement = elementArray[i];
        break;
    }
}
*/

// 或使用 filter
const foundElementArray = elementArray.filter(element => element.innerText.trim() === "搜索");
if (foundElementArray.length) {
    foundElement = foundElementArray[0];
}

簡而言之：

innerText 獲取元素第一層的文本內容，不包含標簽；
innerHTML 如其名獲取內部 HTML 片段，包含標簽；
textContent 類似 innerText，不過會在去掉標簽后將嵌套的純文本內容也獲取出來。

MDN textContent"s difference from innerText and innerHTML