BOM(Browser Object Model,瀏覽器物件模型)提供了一組用來存取瀏覽器功能的物件,這些功能與任何網頁內容無關。
BOM 缺少正式標準,各家瀏覽器供應商各自擴充,因此 window 物件事實上就成了共同標準。直到 HTML5 才把 BOM 中常用的部分納入規範。
// BOM 的核心物件是 window,它代表瀏覽器的一個實例
// window 位於 JavaScript 結構的最頂層,每個開啟的視窗都會自動定義一個
// window 同時扮演 ECMAScript 中 Global 物件的角色
// 因此所有在全域作用域中宣告的變數與函式,都會變成 window 的屬性和方法
var newValue = oldValue; // => ReferenceError: oldValue is not defined
var newValue = window.oldValue; // => undefined,不丟例外
這個特性有個實用副作用:查詢 window 的屬性不會拋錯,因此可以用來偵測某個物件是否存在。
| 屬性 | 說明 |
|---|---|
| closed | 視窗關閉時為 true |
| defaultStatus | 狀態欄的預設文字 |
| document | 視窗中目前的文件物件 |
| frames | 視窗中的框架集合 |
| history | 視窗最近載入的 URL 記錄 |
| length | 視窗中的框架數量 |
| location | 目前視窗的 URL |
| name | 視窗名稱 |
| opener | 開啟目前視窗的視窗 |
| parent | 包含目前視窗的父視窗(供框架使用) |
| screen | 螢幕相關資訊,如寬高(像素) |
| self / window | 指示目前視窗本身 |
| status | 狀態欄的臨時資訊 |
| top | 最頂層的視窗(供框架使用) |
| 方法 | 說明 |
|---|---|
| alert(text) | 警告對話框 |
| blur() / focus() | 移除/移轉焦點至視窗 |
| clearInterval(id) / clearTimeout(id) | 清除間歇/超時計時器 |
| close() | 關閉視窗 |
| confirm() | 需要確認的對話框 |
| open(url, name, options) | 開啟新視窗並回傳其 window 物件 |
| prompt(text, default) | 要求使用者輸入的對話框 |
| scroll(x, y) | 捲動到指定像素位置 |
| setInterval(fn, ms) | 每隔指定時間重複執行 |
| setTimeout(fn, ms) | 指定時間後執行一次 |
| print() | 叫出列印對話框 |
| find() | 叫出尋找對話框 |
這些屬性與方法既可以寫成 window.alert(text),也可以直接 alert(text)。
瀏覽器透過 alert()、confirm()、prompt() 呼叫系統對話框。它們與網頁內容無關、不包含 HTML,外觀由作業系統與瀏覽器決定而非 CSS。
這幾個方法開啟的對話框都是同步且模態的:顯示期間程式碼停止執行,關閉後才恢復。
alert('警告');
if (confirm('請確定或取消')) {
alert('您選擇了確定'); // confirm() 回傳 true
} else {
alert('您選擇了取消'); // 回傳 false
}
var num = prompt('請輸入一個數字', 0); // 第二個參數是輸入框的預設值
alert(num);
print(); // 叫出列印視窗
find(); // 等同 Ctrl+F,找到時回傳 true
defaultStatus = '狀態欄預設文字';
status = '狀態欄臨時文字';
window.open() 可以導航到指定 URL,也可以開啟新的瀏覽器視窗。它接受四個參數:要載入的 URL、視窗名稱或目標、特性字串、以及是否取代歷史記錄中的目前頁面。
open('https://www.baidu.com'); // 新分頁並跳轉
open('https://www.baidu.com', '搜索引擎'); // 命名視窗;再次呼叫只會刷新該視窗
open('https://www.baidu.com', '_parent'); // 在目前頁面開啟
open('https://www.baidu.com', '_blank'); // 指定在新分頁開啟
注意 URL 必須帶上協定,寫成 open('www.baidu.com') 會被當成相對路徑而失敗。
| 設定 | 值 | 說明 |
|---|---|---|
| width / height | 數值 | 新視窗寬高,不小於 100px |
| top / left | 數值 | 新視窗的 Y / X 座標,不可為負 |
| location | 布林 | 是否顯示網址列,各瀏覽器預設值不同 |
| menubar | 布林 | 是否顯示選單列,預設 no |
| resizable | 布林 | 是否可拖曳邊框調整大小,預設 no |
| scrollbars | 布林 | 內容超出時是否顯示捲軸,預設 no |
| status | 布林 | 是否顯示狀態列,預設 no |
| toolbar | 布林 | 是否顯示工具列,預設 no |
| fullscreen | 布林 | 是否最大化,僅 IE 支援 |
open('https://www.baidu.com', 'baidu',
'width=400,height=400,top=200,left=200,toolbar=yes');
現代瀏覽器基於安全考量,多半會忽略大部分特性設定,一律以新分頁開啟。若要製造真正的彈出視窗效果,請改用 <dialog> 或 window.showModalDialog 的替代方案。
var box = open(); // 開啟一個空白視窗並取得其 window 物件
box.alert(''); // 對新視窗操作
// 子視窗操作父視窗
document.onclick = function() {
opener.document.write('子視窗讓我輸出的!');
};
// IE、Safari、Opera、Chrome 提供 screenLeft / screenTop
// Firefox 提供 screenX / screenY
alert(screenLeft); // IE:視窗左側距螢幕的距離
alert(screenX); // Firefox:同上
// 跨瀏覽器寫法
var leftX = (typeof screenLeft == 'number') ? screenLeft : screenX;
alert(outerWidth); // 視窗本身含邊框的尺寸
alert(outerHeight);
alert(innerWidth); // 頁面可視區域尺寸
alert(innerHeight);
IE 未提供對應的屬性,需改用 document.documentElement.clientWidth;IE6 在 quirks mode 下則要用 document.body.clientWidth:
var width = window.innerWidth;
var height = window.innerHeight;
if (typeof width != 'number') { // 舊 IE
if (document.compatMode == 'CSS1Compat') {
width = document.documentElement.clientWidth;
height = document.documentElement.clientHeight;
} else {
width = document.body.clientWidth;
height = document.body.clientHeight;
}
}
document.compatMode 可判斷頁面是否處於標準模式。
moveTo(0, 0); // 移動到 (0, 0)
moveBy(10, 10); // 向右下各移動 10px
resizeTo(200, 200); // 調整為指定大小
resizeBy(200, 200); // 相對目前大小增減
這些方法在現代瀏覽器中通常對一般分頁無效,只有以 open() 開啟且具備 resizable 的視窗才可能生效。
JavaScript 是單執行緒語言,但允許透過設定超時值與間隔值來調度程式碼在特定時刻執行。
setTimeout(function() {
alert('警告!');
}, 1000); // 回傳一個數值 ID,是該次超時調用的唯一識別碼
var box = setTimeout(function() {
alert('超時調用');
}, 1000);
clearTimeout(box); // 取消尚未執行的超時調用
優先傳入函式參照而非字串,可擴充性與效能都更好:
setTimeout(function() { ShowMsg(a, b); }, 1000); // 建議
setTimeout("ShowMsg(a, b)", 1000); // 不建議,需 eval
var pox = setInterval(function() {
alert('間隔調用');
}, 1000);
clearInterval(pox); // 取消間歇調用
// 五分鐘後ells
var num = 0, max = 5;
setInterval(function() {
num++;
if (num == max) {
clearInterval(this); // this 指向方法本身,可用來追蹤 ID
alert('5 秒後彈窗');
}
}, 1000);
間歇調用有個風險:函式執行時間若超過間隔,下一次調用會在前一次結束前就啟動,造成堆積與同步問題。改用超時調用遞迴則永遠不會重疊:
var num = 0, max = 5;
function box() {
num++;
if (num == max) {
alert('5 秒後彈窗');
} else {
setTimeout(box, 1000); // 隔一秒後再次安排
}
}
setTimeout(box, 1000);
這種寫法也不必追蹤計時器 ID——每次執行完若不再安排下一次,調用自然停止。
location 是 BOM 的物件之一,提供與目前視窗所載入文件相關的資訊,以及一些導航功能。它同時是 window 與 document 的屬性。
| 屬性 | 對應的 URL 部分 |
|---|---|
| hash | 錨點部分,以 # 開頭 |
| host | 主機名:連接埠 |
| hostname | 主機名 |
| href | 完整的 URL |
| pathname | 路徑名 |
| port | 連接埠 |
| protocol | 協定部分 |
| search | 查詢字串,以問號開頭 |
| 方法 | 說明 |
|---|---|
| assign(url) | 跳轉到指定頁面,等同設定 href |
| reload() | 重新載入目前 URL |
| replace(url) | 以新 URL 取代目前頁面,且不留下歷史記錄 |
location.hash = '#1'; // 設定錨點並跳轉
location.hostname = 'example.com';
location.search = '?id=5';
location.assign('https://www.baidu.com');
location.reload();
location.reload(true); // 強制從伺服器重新載入,略過快取
location.replace('https://www.baidu.com'); // 不產生歷史記錄的跳轉
function getArgs() {
var args = [];
var qs = location.search.length > 0 ? location.search.substring(1) : '';
var items = qs.split('&');
for (var i = 0; i < items.length; i++) {
var item = items[i].split('=');
var name = decodeURIComponent(item[0]);
var value = decodeURIComponent(item[1]);
args[name] = value; // 每個參數都成為 args 的屬性
}
return args;
}
var args = getArgs();
alert(args['id']);
現在有更好的原生方案,不必自己解析:
const params = new URLSearchParams(location.search);
const id = params.get('id');
const all = Object.fromEntries(params.entries());
history 是 window 的屬性,保存著使用者上網的記錄,從視窗被打開的那一刻開始累積。
history.length; // 記錄數量
history.back(); // 等同瀏覽器的後退
history.forward(); // 等同瀏覽器的前進
history.go(-2); // 往後跳 2 頁
history.go(1); // 往前跳 1 頁
可透過 history.length == 0 判斷是否還有歷史記錄。在 SPA 中操作 history 而不重新載入頁面,請使用 History API 的 pushState() 與 replaceState()。
瀏覽器物件模型(BOM)以 window 物件為核心,代表瀏覽器視窗以及頁面的可視區域。同時 window 還是 ECMAScript 中的 Global 物件,因此所有全域變數與函式都是它的屬性,所有原生建構函式與其他函式也都存在於它的命名空間下。
replace() 可導航到新 URL 並取代歷史記錄中的目前頁面。setTimeout 與 setInterval;實務上以超時調用遞迴模擬間歇調用較為穩健。
BOM 的標準現由 HTML Living Standard 涵蓋,本文中屬於舊式或非標準的部分(defaultStatus、find()、offscreenBuffering、以 open() 控制視窗外觀)在新專案中應避免。此外還有一批不在本文範圍內但常用的現代 BOM API:
navigator.clipboard:讀寫剪貼簿localStorage / sessionStorage:瀏覽器端儲存fetch:取代 XMLHttpRequest 的請求 APINotification:系統通知matchMedia:在 JS 中查詢媒體條件