javascript - 矩形图() : is the documentation wrong?

Question

Mozilla's Rect Class

在 Mozilla 的矩形类文档中 Rect ，他们提到的功能之一是 map() function，它接受一个函数作为参数。该函数的描述为:

Calls a specified function on each of the left, right, top, and bottom values of the rectangle.

但是矩形的固有属性是x , y , width ，和height 。虽然矩形的“右”和“底”很容易计算出来，但 map 看起来很奇怪。函数将修改计算值，而不是 Rect 的实际属性目的。这是文档中的拼写错误吗？这不会那么奇怪；在单独查看该页文档时，我发现了其他几个小拼写错误，但这实际上影响了该函数的工作方式。自 Rect class 不是一个需要实例化的类，我也不知道如何测试 Mozilla 的代码来亲自检查这一点。

我了解 map 函数的概念及其用途，但我不经常使用它们，所以也许这就是它们通常的工作方式。对四个相同类型的值(左、上、右、下:位置)调用相同的函数是有意义的，而不是对一个(x、y:位置)和两个值中的两个调用相同的函数。另一个(宽度，高度:数量)。

Answer 1

通过在DXR上查找Rect对象，似乎文档是correct .

通过一些代码学(我编了这个词，代码+考古学:-D)，我发现 map 函数是用 bug 520910 引入的。 。审阅者似乎并不关心使用 right 和 bottom 代替 height 和 width。

意见:正如您所说，映射到四个相同类型的值(左、上、右、下:位置)是有意义的。这甚至更有意义，因为 width 和 height 仅用于初始化 Rect:right 和 底部 是始终使用的 internally .

专业提示:如果您想检查 Mozilla 的代码，您可以使用 DXR 查看代码(甚至可以快速搜索!) .