在 Flash 仍常見的年代,網頁常需要 JavaScript 與 Flash 互相傳值——例如 JS 告訴 Flash 要播哪一首背景音樂。這個範例記錄了一個很典型的非同步時序 bug 及其解法。
JS 呼叫 Flash 中透過 ExternalInterface.addCallback() 開放的函式時,能否成功帶值帶有隨機性:有時候可以,有時候不行。
問題不在 JS 也不在 ActionScript,而在時序。<object></object> 標籤出現在頁面上,並不代表 Flash 內容已經載入完成。當 JS 在 Flash 還沒就緒時就呼叫它開放的 callback,值自然傳不過去——Flash 內部還沒建立好接收的通道,卻已經開始播放音樂,結果什麼都沒聽到。
這是典型的「非同步資源就緒性」問題:載入是非同步的,而呼叫是同步發出的,兩者沒有協調機制。
Flash 開放了一個 PercentLoaded 屬性給 JS 使用,回報自身載入百分比。只要輪詢這個值等到 100,就代表 Flash 已完成初始化,可以安全傳值:
var checkFlashLoaded = setInterval(function() {
if (flash.PercentLoaded == 100) {
flash.setBGMusic("bkmusic.mp3");
clearInterval(checkFlashLoaded); // 完成後停止輪詢
}
}, 10);
邏輯很簡單:每 10 毫秒檢查一次載入百分比,未滿 100 就繼續等,滿了才傳值並清除計時器。這樣就能保證傳值時機正確。
等號寫錯。原範例寫成 if(flash.PercentLoaded = 100)——這是赋值而非比較。它會把 100 塞進 PercentLoaded,運算式回傳 100(truthy),於是 if 永遠成立,輪詢等於沒作用,問題照樣存在。正確寫法是 == 或 ===。
輪詢間隔太短。10ms 的間隔對「等 Flash 載入」這種秒級的操作顯得過於頻繁,白白消耗 CPU。改成 100ms 或 200ms 綽綽有餘,使用者根本感知不到差別。
輪詢是「拉」(pull)模式,比較粗糙。更好的做法是讓 Flash 在初始化完成時主動呼叫 JS,也就是「推」(push):
// ActionScript 端,初始化完成後執行
ExternalInterface.call("onFlashReady");
// JavaScript 端
function onFlashReady(){
flash.setBGMusic("bkmusic.mp3");
}
這個方式沒有延遲、沒有空轉、也不依賴任何進度屬性,是 Flash 與 JS 互動的建議做法。若同時要防「Flash 載入失敗」,可以再加上逾時機制:
var timeout = setTimeout(function(){
console.warn('Flash 載入逾時');
}, 10000);
function onFlashReady(){
clearTimeout(timeout);
flash.setBGMusic("bkmusic.mp3");
}
Flash 已於 2020 年底停止支援,這段程式碼今天只剩歷史價值。但它揭示的問題模式完全不過時:任何非同步資源的初始化完成時機,都需要明確的通知機制。今天同樣的情境包括:
img.onload 或 decode(),別以為設了 src 就能立刻 drawImage。document.fonts.ready,否則 canvas 畫字會用到不對的字型。<script> 的 onload,或改用 <script type="module"> 並動態 import()。iframe.onload,跨源時則用 postMessage 協商就緒。核心原則是:不要假設「設定了就等於完成了」,一定要有明確的就緒通知或狀態檢查。另外,永遠注意比較運算中的 = 與 == 之別,這是 JavaScript 最經典的靜默 bug 之一。