upload_progress_jsonp_parameter
指令 `upload_progress_jsonp_parameter` 指定用于以 JSONP 格式返回上传进度信息的 JSONP 参数名称。
NGINX upload progress tracking module
·
httpserverlocation
语法upload_progress_jsonp_parameter ;
默认值none
上下文http, server, location
参数1
说明
指令 upload_progress_jsonp_parameter 在 NGINX 的上传进度跟踪模块中使用，用于定义将用于 JSONP 回调的查询参数名称。当客户端应用发出请求以获取上传进度时，可以在请求 URL 中包含该参数。NGINX 会识别该参数并相应地格式化响应数据，使响应能够作为 JavaScript 函数调用执行，从而在需要通过 JSONP 进行跨域请求的应用中提供无缝的上传进度监控体验。
该指令必须在适当的上下文中定义，例如在 http、server 或 location 块中，具体取决于希望在哪些位置进行上传进度跟踪。典型用法允许开发者根据客户端应用的需要自定义回调参数名称。该指令的值应为一个字符串，表示所需的 JSONP 参数名称，例如 'callback'，从而使客户端能够将格式化的进度报告直接传入指定的回调函数。
务必确保在该指令中定义的参数名称与客户端应用预期的一致，以避免接收上传进度更新时出现问题。该指令与 NGINX 提供的整体上传进度报告机制协同工作，该机制利用共享内存和事件驱动模型来高效地跟踪上传的状态和进度。
配置示例
location /upload {
track_uploads my_zone 10s;
upload_progress_jsonp_parameter callback;
}⚠
确保参数名与客户端应用程序期望的名称匹配，以避免 JSONP 回调不触发的问题。
⚠
记得在相同或父级上下文中包含 track_uploads 指令，以启用上传进度监控。