Utils

This is an overview of all the utility functions bound to the shopware global object. Utility functions provide many useful shortcuts for common tasks, see how to use them in your plugin here. Or see the code that registers them here

General functions

Function	Description	Link
createId	Returns a uuid string in hex format. Generated with uuid
throttle	Creates a throttled function that only invokes func at most once per every wait milliseconds.	link
debounce	Creates a debounced function that delays invoking func until after wait milliseconds have elapsed since the last time the debounced function was invoked.	link
flow	Creates a function that returns the result of invoking the given functions with the this binding of the created function, where each successive invocation is supplied the return value of the previous.	link
get	Gets the value at path of object	link

Object

Function	Description	Link
deepCopyObject	Deep copy an object
hasOwnProperty	Shorthand method for Object.prototype.hasOwnProperty
getObjectDiff	Gets a simple recursive diff of two objects. Does not consider an entity schema or entity related logic.
getArrayChanges	Check if the compared array has changes.
cloneDeep	Creates recursively a clone of value.	link
merge	This method is like _.assign except that it recursively merges own and inherited enumerable string keyed properties of source objects into the destination object.	link
mergeWith	This method is like _.merge except that it accepts customizer which is invoked to produce the merged values of the destination and source properties.	link
deepMergeObject	Deep merge two objects
get	Gets the value at path of object	link
set	Sets the value at path of object	link
pick	Creates an object composed of the picked object properties.	link

Debug

Function	Description
warn	General logging function which provides a unified style of log messages for developers. Please keep the log in mind. Messages will be displayed in the developer console when they're running the application in development mode.
debug	The same as warn but instead of console.warn it uses console.error.

Format

Function	Description
currency	Converts a number to a formatted currency. Especially helpful for template filters.
date	Formats a Date object to a localized string with the native Intl.DateTimeFormat method
fileSize	Formats a number of bytes to a string with a unit
md5	Generates a md5 hash with md5-es of a given value.

Dom

Function	Description
getScrollbarHeight	Returns the scrollbar height of an HTML element.
getScrollbarWidth	Returns the scrollbar width of an HTML element.
copyToClipboard	Uses the browser's copy function to copy a string

String

Function	Description	Link
capitalizeString	Converts the first character of string to upper case and the remaining to lower case.	link
camelCase	Converts string to camel case.	link
kebabCase	Converts string to kebab case.	link
snakeCase	Converts string to snake case.	link
md5	Generates a md5 hash with md5-es of a given value.
isEmptyOrSpaces	Gets if the content of the string is really empty. This does also removes any whitespaces that might exist in the text.
isUrl	Checks if the provided value is a URL
isValidIp	Checks if the provided value is an IP with this Regex

Type

Function	Description	Link
isObject	Checks if value is the language type of Object. (e.g. arrays, functions, objects, regexes, new Number(0), and new String(''))	link
isPlainObject	Checks if value is a plain object, that is, an object created by the Object constructor or one with a [[Prototype]] of null.	link
isEmpty	Checks if value is an empty object, collection, map, or set.	link
isRegExp	Checks if value is classified as a RegExp object.	link
isArray	Checks if value is classified as an Array object.	link
isFunction	Checks if value is classified as a Function object.	link
isDate	Checks if value is classified as a Date object.	link
isString	Checks if value is classified as a String primitive or object.	link
isBoolean	Checks if value is classified as a boolean primitive or object.	link
isEqual	Performs a deep comparison between two values to determine if they are equivalent.	link
isNumber	Checks if value is classified as a Number primitive or object.	link
isUndefined	Checks if value is undefined.

Filereader

Function	Description	Link
readAsArrayBuffer	Reads a file as an ArrayBuffer	link
readAsDataURL	Reads a file as a Data-URL	link
readAsText	Reads a file as text	link
getNameAndExtensionFromFile	Gets the name and extension from a file
getNameAndExtensionFromUrl	Gets the name and extension from a URL

Sort

Function	Description
afterSort	Sorts the elements by their after id property chain

Array

Function	Description	Link
flattenDeep	Recursively flattens array.	link
remove	Removes all elements from array that predicate returns truthy for and returns an array of the removed elements	link
slice	Creates a slice of array from start up to, but not including, end.	link
uniqBy	This method is like _.uniq except that it accepts iteratee which is invoked for each element in array to generate the criterion by which uniqueness is computed.	link