feat(method): new 'specTextValue' method

src/index.js

@@ -21,6 +21,7 @@ import inStock from './methods/in-stock'
 import searchedItems from './methods/searched-items'
 import splitCategoryTree from './methods/split-category-tree'
 import specValues from './methods/spec-values'
+import specTextValue from './methods/spec-text-value'
 
 /**
  * JS utility functions for E-Com Plus (not only) related apps.
@@ -56,7 +57,8 @@ export {
   inStock,
   searchedItems,
   splitCategoryTree,
-  specValues
+  specValues,
+  specTextValue
 }
 
 /**

src/methods/spec-text-value.js

@@ -0,0 +1,36 @@
+import specValues from './specValues'
+
+const specTextValue = (product, gridId, grids, delimiter = ', ') => {
+  // using text property of each spec object
+  let values = specValues(product, gridId, grids)
+  if (values.length) {
+    let valuesString = values[0].text
+    for (let i = 1; i < values.length; i++) {
+      valuesString += delimiter + values[i].text
+    }
+    return valuesString
+  }
+  // specification not found
+  return null
+}
+
+/**
+ * @method
+ * @memberof ecomUtils
+ * @name specTextValue
+ * @description Parse specifications array of nested objects to string.
+ * @param {object|array} product - Product body or array of variation objects
+ * @param {string} gridId - Grid ID string such as 'color'
+ * @param {array} [grids] - List of grid objects
+ * @param {string} [delimiter=', '] - Delimiter between each specification
+ * @returns {string|null}
+ *
+ * @example
+ * // TODO
+ *
+ * @example
+ * // Importing this method standalone
+ * import specTextValue from '@ecomplus/utils/dist/methods/spec-text-value'
+ */
+
+export default specTextValue