buffer-source.js 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101
  1. const ARRAY_BUFFER_TAG = "[object ArrayBuffer]";
  2. const SHARED_ARRAY_BUFFER_TAG = "[object SharedArrayBuffer]";
  3. function tagOf(value) {
  4. return Object.prototype.toString.call(value);
  5. }
  6. function isDataViewConstructor(type) {
  7. return type === DataView || type.prototype instanceof DataView;
  8. }
  9. function bytesPerElement(type) {
  10. if (isDataViewConstructor(type)) {
  11. return 1;
  12. }
  13. const value = type.BYTES_PER_ELEMENT;
  14. return value ?? 1;
  15. }
  16. function isArrayBufferViewLike(value) {
  17. if (ArrayBuffer.isView(value)) {
  18. return true;
  19. }
  20. if (!value || typeof value !== "object") {
  21. return false;
  22. }
  23. const view = value;
  24. return typeof view.byteOffset === "number"
  25. && typeof view.byteLength === "number"
  26. && isArrayBufferLike(view.buffer);
  27. }
  28. function copyBytes(data) {
  29. const view = toUint8Array(data);
  30. const copy = new Uint8Array(view.byteLength);
  31. copy.set(view);
  32. return copy;
  33. }
  34. export function isArrayBuffer(value) {
  35. return tagOf(value) === ARRAY_BUFFER_TAG;
  36. }
  37. export function isSharedArrayBuffer(value) {
  38. return typeof SharedArrayBuffer !== "undefined" && tagOf(value) === SHARED_ARRAY_BUFFER_TAG;
  39. }
  40. export function isArrayBufferLike(value) {
  41. return isArrayBuffer(value) || isSharedArrayBuffer(value);
  42. }
  43. export function isArrayBufferView(value) {
  44. return isArrayBufferViewLike(value);
  45. }
  46. export function isBufferSource(value) {
  47. return isArrayBufferLike(value) || isArrayBufferView(value);
  48. }
  49. export function assertBufferSource(value) {
  50. if (!isBufferSource(value)) {
  51. throw new TypeError("Expected ArrayBuffer, SharedArrayBuffer, or ArrayBufferView");
  52. }
  53. }
  54. export function toUint8Array(data) {
  55. assertBufferSource(data);
  56. if (isArrayBufferLike(data)) {
  57. return new Uint8Array(data);
  58. }
  59. return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
  60. }
  61. export function toUint8ArrayCopy(data) {
  62. return copyBytes(data);
  63. }
  64. export function toArrayBuffer(data) {
  65. assertBufferSource(data);
  66. if (isArrayBuffer(data)) {
  67. return data;
  68. }
  69. const buffer = new ArrayBuffer(data.byteLength);
  70. new Uint8Array(buffer).set(toUint8Array(data));
  71. return buffer;
  72. }
  73. export function toArrayBufferLike(data) {
  74. assertBufferSource(data);
  75. if (isArrayBufferLike(data)) {
  76. return data;
  77. }
  78. if (data.byteOffset === 0 && data.byteLength === data.buffer.byteLength) {
  79. return data.buffer;
  80. }
  81. return copyBytes(data).buffer;
  82. }
  83. export function toView(data, type) {
  84. assertBufferSource(data);
  85. if (ArrayBuffer.isView(data) && data.constructor === type) {
  86. return data;
  87. }
  88. const view = toUint8Array(data);
  89. const elementSize = bytesPerElement(type);
  90. if (view.byteOffset % elementSize !== 0 || view.byteLength % elementSize !== 0) {
  91. throw new RangeError(`Cannot create ${type.name} over unaligned byte range`);
  92. }
  93. if (isDataViewConstructor(type)) {
  94. return new type(view.buffer, view.byteOffset, view.byteLength);
  95. }
  96. return new type(view.buffer, view.byteOffset, view.byteLength / elementSize);
  97. }
  98. export function toViewCopy(data, type) {
  99. const copy = toUint8ArrayCopy(data);
  100. return toView(copy, type);
  101. }