Deno 移除了 Deno.Buffer、Deno.readAll、Deno.copy 等一系列 API

justjavac · 2021 年4 月 19 日 05:29

Remove pure JS (non native) io functions from Deno namespace

opened 01:52PM - 15 Mar 21 UTC

breaking change maybe 2.0 public API suggestion

I propose we remove the following APIs from the Deno namespace, and move them to… std: Types: - [ ] `Deno.Reader` - [ ] `Deno.Writer` - [ ] `Deno.ReaderSync` - [ ] `Deno.WriterSync` - [ ] `Deno.Closer` Functions: - [x] `Deno.Buffer` (#9793) - [ ] `Deno.copy` - [x] `Deno.iter` (#10025) - [x] `Deno.iterSync` (#10025) - [x] `Deno.readAll` (#9793) - [x] `Deno.readAllSync` (#9793) - [x] `Deno.writeAll` (#9793) - [x] `Deno.writeAllSync` (#9793) ### Timeline I suggest we mark all the APIs we want to remove with `@deprecated`, and add a `deno lint` diagnostic for when these APIs are used. In Deno 2.0 we can then remove these APIs. ### Reasoning Code which does not actually require native syscalls should not use `Deno` namespace APIs as this makes the code incompatible with browsers, even though there is no need for that to be the case. An example of this: https://deno.land/std@0.90.0/io/streams.ts. This uses `Deno` APIs, even though no native calls are preformed, making this code unusable in a web browser for no good reason.

Deno 移除了一系列 API，将他们从 Deno namespace 移动到了 std/io 库：

类型：

Deno.Reader
Deno.Writer
Deno.ReaderSync
Deno.WriterSync
Deno.Closer

函数：

Deno.Buffer (#9793)
Deno.copy
Deno.iter (#10025)
Deno.iterSync (#10025)
Deno.readAll (#9793)
Deno.readAllSync (#9793)
Deno.writeAll (#9793)
Deno.writeAllSync (#9793)

时间线

在已经发布的 1.9 版本中已经将这些类型和 API 标记为了 @deprecated，deno lint 也会给出提示。在未来的 2.0 版本这些类型和 API 会被彻底移出。

原因

此次更改的原因是这些 API 都没有任何 native 操作，适合放到 std 中。这样也可以使得 Deno 程序更方便的迁移到浏览器或者其他非 Deno 平台上。