feat: read returns undefined if offset is not in range.

Author: ghosind

src/dynamicBuffer.ts

@@ -538,16 +538,14 @@ export class DynamicBuffer {
    * // 72
    * ```
    *
-   * @param offset Number of bytes to skip before starting to read, and the offset must satisfy
-   * between 0 and `this.length`, default `0`.
+   * @param offset Number of bytes to skip before starting to read, default `0`.
    * @returns The byte at the position in the buffer.
    */
-  read(offset: number = 0): number {
+  read(offset: number = 0): number | undefined {
     if (!this.buffer || offset < 0 || offset >= this.used) {
-      rangeCheck('offset', offset, 0, this.used - 1);
+      return undefined;
     }
 
-    // @ts-ignore
     return this.buffer[offset];
   }
 

test/read.spec.ts

@@ -29,19 +29,15 @@ describe('Read tests', () => {
 
     buffer.append('Hello world');
 
-    assert.throws(() => {
-      buffer.read(-1);
-    });
+    assert.equal(buffer.read(-1), undefined);
   });
 
   it('Test read with a offset larger than buffer length', () => {
     const buffer = new DynamicBuffer();
 
     buffer.append('Hello world');
 
-    assert.throws(() => {
-      buffer.read(buffer.length + 1);
-    });
+    assert.equal(buffer.read(buffer.length + 1), undefined);
   });
 });