萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 手寫 JSONP 核心實現:跨域請求原理與源碼級解析

JSONP 原理速覽

瀏覽器同源策略限制 XMLHttpRequest/fetch 跨域,但 <script>、<img>、<link> 標籤的 src/href 不受限。JSONP 利用此特性:

  1. 前端動態創建 <script src="https://api.example.com/data?callback=fn"></script>
  2. 服務端返回 fn({"key":"value"})(調用預約好的全局回調函數)
  3. 瀏覽器執行腳本,觸發 fn,數據進入前端作用域

手寫 JSONP 核心流程(簡化版)

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 內部 JSONP 實現源碼解析(節選自 jQuery 3.x)

原文代碼展示了 jQuery 如何在 $.ajax 內部處理 dataType: 'jsonp',關鍵步驟:

1. 預檢與參數標準化

function prescript(s) {
  if (s.cache === undefined) s.cache = false; // JSONP 默認不緩存
  if (s.crossDomain) s.type = 'GET'; // 強制 GET
}

2. JSONP 預處理:構建回調、修改 dataType

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 標籤發請求
}

3. 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');
    }
  };
}

4. 完整 ajax 流程串聯

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 的局限與現代替代方案

維度JSONPCORSProxy
請求方式僅 GET支持所有 HTTP 方法支持所有
安全性易受 XSS、CSRF 攻擊瀏覽器強制同源檢查服務端可控
錯誤處理難以捕獲 HTTP 狀態碼完整支持完整支持
瀏覽器支持全支持(IE6+)IE10+全支持
推薦度⭐ (僅兼容舊環境)

現代項目最佳實踐

  1. 首選 CORS:後端配置 Access-Control-Allow-Origin,前端正常 fetch/axios
  2. 次選 Node/BFF 層代理:前端請求同域 BFF,BFF 轉發至下游服務,隱藏內網結構
  3. 極少數場景用 JSONP:嵌入第三方無 CORS 支持的舊系統(如老廣告 SDK、統計代碼)
  4. 安全加固:若必須用 JSONP,嚴格驗證回調函數名格式、限制調用域名、使用 nonce 或 CSP 限制腳本執行

總結

JSONP 是「腳本標籤跨域」的巧妙利用,jQuery 將其封裝進 $.ajax 統一接口,體現了「適配器模式」的優雅。理解其內部機制(動態腳本注入、全局回調劫持、Promise 化清理)有助於排查跨域疑難雜症。但在現代前端工程中,CORS + 代理層才是標準解法,JSONP 應作為歷史兼容方案逐步退出歷史舞台。

copyright © 萬盛學電腦網 all rights reserved