1. /**
  2. * Array Assertions for CLI
  3. */
  5. const assertArray = (arr, message, condition) => {
  6. if (!Array.isArray(arr)) {
  7. console.error(`Assertion failed: ${message}. Expected an array.`);
  8. return false;
  9. }
  11. if (!condition(arr)) {
  12. console.error(`Assertion failed: ${message}.`);
  13. return false;
  14. }
  16. return true;
  17. };
  19. /**
  20. * Checks if an array is empty
  21. * @param {Array} arr The array to check
  22. * @param {string} message The error message if the assertion fails
  23. * @returns {boolean} True if the array is empty, false otherwise.
  24. */
  25. const isEmpty = (arr, message) => {
  26. return assertArray(arr, message, (a) => a.length === 0);
  27. };
  29. /**
  30. * Checks if an array contains only numbers
  31. * @param {Array} arr The array to check
  32. * @param {string} message The error message if the assertion fails
  33. * @returns {boolean} True if the array contains only numbers, false otherwise.
  34. */
  35. const allNumbers = (arr, message) => {
  36. return assertArray(arr, message, (a) => typeof a === 'number' && !isNaN(a));
  37. };
  39. /**
  40. * Checks if an array contains unique elements
  41. * @param {Array} arr The array to check
  42. * @param {string} message The error message if the assertion fails
  43. * @returns {boolean} True if the array contains unique elements, false otherwise.
  44. */
  45. const areUnique = (arr, message) => {
  46. const seen = new Set();
  47. return assertArray(arr, message, (a) => {
  48. if (seen.has(a)) {
  49. console.error(`Assertion failed: ${message}. Array contains duplicate elements.`);
  50. return false;
  51. }
  52. seen.add(a);
  53. return true;
  54. });
  55. };
  57. /**
  58. * Checks if an array is sorted in ascending order
  59. * @param {Array} arr The array to check
  60. * @param {string} message The error message if the assertion fails
  61. * @returns {boolean} True if the array is sorted, false otherwise.
  62. */
  63. const isSortedAscending = (arr, message) => {
  64. return assertArray(arr, message, (a, b) => a <= b);
  65. };
  67. /**
  68. * Checks if an array is sorted in descending order
  69. * @param {Array} arr The array to check
  70. * @param {string} message The error message if the assertion fails
  71. * @returns {boolean} True if the array is sorted, false otherwise.
  72. */
  73. const isSortedDescending = (arr, message) => {
  74. return assertArray(arr, message, (a, b) => a >= b);
  75. };
  77. /**
  78. * Checks if an array contains a specific value.
  79. * @param {Array} arr The array to check.
  80. * @param {any} value The value to search for.
  81. * @param {string} message The error message if the assertion fails.
  82. * @returns {boolean} True if the array contains the value, false otherwise.
  83. */
  84. const containsValue = (arr, value, message) => {
  85. return assertArray(arr, message, (a) => a === value);
  86. };
  88. /**
  89. * Checks if an array has a specific length.
  90. * @param {Array} arr The array to check.
  91. * @param {number} expectedLength The expected length of the array.
  92. * @param {string} message The error message if the assertion fails.
  93. * @returns {boolean} True if the array has the expected length, false otherwise.
  94. */
  95. const hasLength = (arr, expectedLength, message) => {
  96. return assertArray(arr, message, (a) => a.length === expectedLength);
  97. };

Add your comment