关于DataView.prototype.getInt32是否应该被标记为long的讨论

[jerry4718]

MDN URL

https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/DataView

与此议题相关的小节或标题？

实例方法

哪些信息是错误、无用或不完善的？

DataView.prototype.getInt32()
从视图开始的指定字节偏移处获取一个带符号 32 位整数（long）。

DataView.prototype.getUint32()
从视图开始的指定字节偏移处获取一个无符号 32 位整数（unsigned long）。

DataView.prototype.setInt32()
在视图开始的指定字节偏移处存储一个带符号 32 位整数（long）。

DataView.prototype.setUint32()
在视图开始的指定字节偏移处存储一个无符号 32 位整数（unsigned long）。

这些内容中的long或者unsigned long标注似乎存在歧义，整个段落中的标注看起来更像是c的风格，但是getInt32返回值为long只在Web IDL中存在，我们明确的知道，这里getInt32只会固定读取32个bits

DataView.prototype.getBigInt64()
从视图开始的指定字节偏移处获取一个带符号 64 位整数（long long）。

DataView.prototype.getBigUint64()
从视图开始的指定字节偏移处获取一个无符号 64 位整数（unsigned long long）。

DataView.prototype.setBigInt64()
在视图开始的指定字节偏移处存储一个带符号 64 位 BigInt（long long）。

DataView.prototype.setBigUint64()
在视图开始的指定字节偏移处存储一个无符号 64 位 BigInt（unsigned long long）。

如果说getInt32的long还勉强可以解释，这里的getBigInt64()也同样出现了奇怪的效果，在Web IDL中，它的类型或许是bigint？而long long和unsigned long long只会让人联想到c

你期望看到什么？

我期望移除掉不明确的类型标注，或者在标注处同时标注出他们的来源，以免造成歧义

你有什么支持的链接、参考或引用？

No response

你还想补充什么内容？

No response

MDN metadata

Page report details

• Folder: zh-cn/web/javascript/reference/global_objects/dataview
• MDN URL: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/DataView
• GitHub URL: https://github.com/mdn/translated-content/blob/main/files/zh-cn/web/javascript/reference/global_objects/dataview/index.md
• Last commit: 1c76a73
• Document last modified: 2024-07-16T08:41:13.000Z

[skyclouds2001]

英文原文只提到返回或设置一个64位的（无符号）整数，并没有提到 BigInt 的内容

另外严格来说， ECMA 中没 webidl 的内容

[jerry4718]

英文原文只提到返回或设置一个64位的（无符号）整数，并没有提到 BigInt 的内容

另外严格来说， ECMA 中没 webidl 的内容

是的，TypedArray这里有提到bigint，但是这个似乎是另外的问题，我只是觉得long或者long long被这样无从考究的标记出来非常奇怪，谁也不知道它源自哪里

[skyclouds2001]

是的，TypedArray这里有提到bigint，但是这个似乎是另外的问题，我只是觉得long或者long long被这样无从考究的标记出来非常奇怪，谁也不知道它源自哪里

这点同意，英文原文就没这样的问题，可能是译者添加的

[yin1999]

这点同意，英文原文就没这样的问题，可能是译者添加的

以前英文文档里面是有这些类型说明的，参见：mdn/content#27618