瀏覽器同源策略限制 XMLHttpRequest/fetch 跨域,但 <script>、<img>、<link> 標籤的 src/href 不受限。JSONP 利用此特性:
<script src="https://api.example.com/data?callback=fn"></script>fn({"key":"value"})(調用預約好的全局回調函數)fn,數據進入前端作用域function jsonp(url, params, callbackName) {
return new Promise((resolve, reject) => {
// 1. 生成唯一回調函數名
var cbName = callbackName || 'jsonp_' + Date.now() + '_' + Math.random().toString(36).substr(2, 5);
// 2. 拼接 URL 參數
var query = Object.keys(params).map(k =>
encodeURIComponent(k) + '=' + encodeURIComponent(params[k])
).join('&');
var separator = url.includes('?') ? '&' : '?';
var fullUrl = url + separator + query + '&callback=' + cbName;
// 3. 掛載全局回調
window[cbName] = function(data) {
resolve(data);
cleanup();
};
// 4. 創建 script 標籤
var script = document.createElement('script');
script.src = fullUrl;
script.async = true;
script.onerror = function() {
reject(new Error('JSONP request failed'));
cleanup();
};
document.head.appendChild(script);
// 5. 超時處理
var timeout = setTimeout(() => {
reject(new Error('JSONP timeout'));
cleanup();
}, 10000);
// 6. 清理函數
function cleanup() {
clearTimeout(timeout);
delete window[cbName];
if (script.parentNode) script.parentNode.removeChild(script);
}
});
}
// 使用
jsonp('https://api.example.com/search', { q: 'javascript', limit: 10 })
.then(data => console.log('結果:', data))
.catch(err => console.error('失敗:', err));
原文代碼展示了 jQuery 如何在 $.ajax 內部處理 dataType: 'jsonp',關鍵步驟:
function prescript(s) {
if (s.cache === undefined) s.cache = false; // JSONP 默認不緩存
if (s.crossDomain) s.type = 'GET'; // 強制 GET
}
function prejsonp(s, originalSettings, jqXHR) {
var callbackName = s.jsonpCallback || 'jQuery' + Date.now(); // 回調名
// 往 URL 追加 callback 參數
s.url += (/\?/.test(s.url) ? '&' : '?') + s.jsonp + '=' + callbackName;
// 重寫 getData:供後續轉換器獲取數據
s.getData = function() {
if (!responseContainer) jQuery.error(callbackName + ' was not called');
return responseContainer[0];
};
// 關鍵:將 dataType 強制為 'json',走 script 輸送機制
s.dataTypes[0] = 'json';
// 保存原全局回調,設置新回調收集數據
var overwritten = window[callbackName];
window[callbackName] = function() {
responseContainer = arguments; // 捕獲服務端傳入的參數
};
return 'script'; // 告訴傳輸器用 script 標籤發請求
}
function inspectPrefiltersOrTransportsB(s, originalOptions, jqXHR) {
return {
send: function(_, complete) {
var script = jQuery('<script>').prop({
async: true,
charset: s.scriptCharset,
src: s.url
}).on('load error', function(evt) {
script.remove();
// 觸發 complete 回調,進入 ajax 成功/失敗流程
if (evt) complete(evt.type === 'error' ? 404 : 200, evt.type);
});
document.head.appendChild(script[0]);
},
abort: function() {
if (script) script.trigger('error');
}
};
}
function createAjax(options) {
// ... 參數合並、Deferred 創建、jqXHR 包裝 ...
// 預處理鏈:jsonp -> script
inspectPrefiltersOrTransportsA(s, options, jqXHR);
// 綁定用戶回調
jQuery.each(['success', 'error', 'complete'], function(i, key) {
jqXHR[key](s[key]);
});
// 獲取傳輸器並發送
var transport = inspectPrefiltersOrTransportsB(s, options, jqXHR);
transport.send(s, done);
return jqXHR;
}
| 維度 | JSONP | CORS | Proxy |
|---|---|---|---|
| 請求方式 | 僅 GET | 支持所有 HTTP 方法 | 支持所有 |
| 安全性 | 易受 XSS、CSRF 攻擊 | 瀏覽器強制同源檢查 | 服務端可控 |
| 錯誤處理 | 難以捕獲 HTTP 狀態碼 | 完整支持 | 完整支持 |
| 瀏覽器支持 | 全支持(IE6+) | IE10+ | 全支持 |
| 推薦度 | ⭐ (僅兼容舊環境) | ||
Access-Control-Allow-Origin,前端正常 fetch/axiosnonce 或 CSP 限制腳本執行JSONP 是「腳本標籤跨域」的巧妙利用,jQuery 將其封裝進 $.ajax 統一接口,體現了「適配器模式」的優雅。理解其內部機制(動態腳本注入、全局回調劫持、Promise 化清理)有助於排查跨域疑難雜症。但在現代前端工程中,CORS + 代理層才是標準解法,JSONP 應作為歷史兼容方案逐步退出歷史舞台。