doc: add note regarding special case of 0 stat.size

dougwilson · targos · commit a8980b2468dd · 2022-07-31T09:45:09.000+02:00
Refs: #43669 PR-URL: #43690 Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Richard Lau <rlau@redhat.com> Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Juan José Arboleda <soyjuanarbol@gmail.com> Reviewed-By: LiviaMedeiros <livia@cirno.name>
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -6341,6 +6341,9 @@ A numeric device identifier if the file represents a device.
 
 The size of the file in bytes.
 
+If the underlying file system does not support getting the size of the file,
+this will be `0`.
+
 #### `stats.blksize`
 
 * {number|bigint}
