Node.js 部分缓冲区写入

我正在详细阅读节点文档，无法理解

buffer.write（）

的解释

具体地说，我不知道当使用大于缓冲区容量的字符串执行写尝试时的行为是什么。下面这段话似乎自相矛盾：

如果缓冲区没有足够的空间容纳整个字符串，它将写入部分字符串。长度默认为buffer.length-offset。该方法不会写入部分字符

第一句话声称它将尽可能地编写，而最后一句说它是一个全有或全无的操作

我遗漏了什么吗？

在某些编码（如UTF-8）中，单个字符可以由多个字节表示

当文档中说“该方法不会写入部分字符”时，我认为它们的意思是，如果一个字符需要3个字节，但缓冲区中只剩下2个字节，那么该字符将根本不会被写入（而不是只写入前2个字节）