document.write 是最直覺的輸出方式:把字串直接寫進 HTML 串流。它語法簡單,但也因為太方便,誤用的代價往往比想像中大。
<script type="text/javascript">
document.write("我是向頁面輸出的文字!");
</script>
用記事本或其他編輯器存成 write.html,雙擊以瀏覽器開啟,頁面上就會出現這行字。
因為寫入的內容會被當成 HTML 解析,所以標籤可以直接放進字串裡:
<script type="text/javascript">
document.write("<h1>我是向頁面輸出的文字!</h1>");
</script>
這段程式會產生一個一級標題,而不是把 <h1> 當成文字顯示。
輸出字串必須用單引號或雙引號包起來,再放進 document.write() 的括號中,陳述式結尾加上分號。它和 alert() 一樣屬於最基礎的 JavaScript 指令,是入門階段很好的練習素材。
最大的問題是執行時機。document.write 只在頁面解析階段安全;一旦在 onload 之後或任何非同步回呼中呼叫,瀏覽器會先清空整個文件再重新寫入,使用者看到的就是一片空白。
次要問題是它會阻塞 HTML 解析,拖慢首屏;而且字串拼接容易產生 XSS 風險,若輸出內容含有使用者輸入的資料,等於直接把攻擊腳本寫進頁面。
正確的替代方式是把內容掛到既有節點上:
// 建立元素
var h1 = document.createElement("h1");
h1.textContent = "我是向頁面輸出的文字!"; // textContent 會自動轉義,較安全
document.body.appendChild(h1);
// 或覆寫既有元素的內容
document.getElementById("content").innerHTML = "<h1>標題</h1>";
兩者的差別在於:innerHTML 會解析字串中的 HTML,而 textContent 一律當純文字處理。只要資料來源不完全可信,就該選 textContent。