`.ajax()` documentation unclear about expectations/data type for `errorThrown`
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 35/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
- 技术栈
- jquery
调研方向
从 $.ajax() 文档开始，重点查看 error 设置及其 errorThrown 参数的说明。协调关于该参数类型的引述内容，并记录 HTTP/2 下 statusText 为空的限制；当预期值和该限制都明确无歧义时，工作即告完成。
由索引模型根据 Issue 内容生成。
描述
Migrated from jQuery repo: https://github.com/jquery/jquery/issues/4211
Description
There is a seeming contradiction in the documentation for $.ajax().
The docs for the error setting of this function indicate:
... The function receives three arguments: The jqXHR (in jQuery 1.4.x, XMLHttpRequest) object, a string describing the type of error that occurred and an optional exception object, if one occurred...
But later the same docs indicate:
... When an HTTP error occurs,
errorThrownreceives the textual portion of the HTTP status, such as "Not Found" or "Internal Server Error." ...
In addition, the docs indicate that the type of the parameter is String. But, based on the first sentence, it sounds like it can be either an object or a string; which is it?
Separately, it appears that the errorThrown will always be an empty string for HTTP errors that occur when using HTTP/2 (aka H2). This appears to be because statusText is always an empty string for an HTTP/2 request (more info: https://stackoverflow.com/questions/41632077/why-is-the-statustext-of-my-xhr-empty).
I'd love it for the jQuery team to weigh-in on both of these limitations in the current docs.
- 主要语言
- HTML
- 星标
- 324
- 派生
- 259
- 平均合并
- 1 天 30 分钟
- 30 天内合并 PR
- 1
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
jquery/api.jquery.com 的其他 Issue
-
Mention of ‘timestamp’ in documentation for ‘cache’ parameter of ‘ajax’ is misleading可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭
难度 1/5 1 小时以内 新手友好度 62/100
jquery/api.jquery.com#1241 · 2 条评论 ·
-
难度 1/5 1 小时以内 新手友好度 68/100
jquery/api.jquery.com#1176 ·
-
The documentation of CSS methods should be further classified可能重新可做 关联的 PR 已关闭且未合并。 未关闭
难度 2/5 1-3 小时 新手友好度 35/100
jquery/api.jquery.com#1281 · 2 条评论 ·
-
难度 2/5 1-3 小时 新手友好度 35/100
jquery/api.jquery.com#1271 · 2 条评论 ·
-
难度 2/5 1-3 小时 新手友好度 45/100
jquery/api.jquery.com#1259 ·
查看 jquery/api.jquery.com 的全部 Issue
相似的 Issue
-
5-minutes algorithm all-levels any-language beginner-friendly community documentation easy first-timers-only good first issue hacktoberfest help wanted learning no-code-needed open-source python students
难度 2/5 1 小时以内 新手友好度 88/100
Huerte/algo-solutions-python#253 ·
维护者通常 1 天内回复
-
size/s
难度 1/5 1 小时以内 新手友好度 90/100
sipyourdrink-ltd/bernstein#7179 ·
维护者通常 1 天内回复
-
area/docs
难度 1/5 1 小时以内 新手友好度 86/100
meshery/meshery#23375 · 1 条评论 ·
维护者通常 1 天内回复
-
Synthetic
难度 1/5 1 小时以内 新手友好度 66/100
samtoth/agda-synthetic-categories#373 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 62/100
tanaabased/big-test-bucket#19952 ·
维护者通常 1 天内回复