in transform stream transform method, `callback(null, null)` doesn't end stream but `this.push(null); callback()` does

Version

latest main branch

Platform

irrelevant

Subsystem

stream

What steps will reproduce the bug?

https://nodejs.org/api/stream.html#transform-transformchunk-encoding-callback

callback(null, null) doesn't end stream but this.push(null); callback() does

How often does it reproduce? Is there a required condition?

Always

What is the expected behavior? Why is that the expected behavior?

callback(null, null) and this.push(null); callback() have the same effect (the stream ends).

What do you see instead?

callback(null, null) is different from this.push(null); callback()

Additional information

https://github.com/nodejs/node/blob/main/lib/internal/streams/transform.js#L177-L179

Would it be possible to change this to the following?

if (val !== undefined) {
  this.push(val)
}

lib/internal/streams/transform.js の177-179行目から始め、Transform callback の文書化された動作と既存の stream 実装を比較します。callback(null, null) と this.push(null); callback() の違いを再現し、その後、関連する stream テストを調べます。両方の形式が説明どおり一貫して stream を終了すれば完了です。