loadStrings()

Loads a text file to create an Array.

The first parameter, path, is always a string with the path to the file. Paths to local files should be relative, as in loadStrings('/assets/data.txt'). URLs such as 'https://example.com/data.txt' may be blocked due to browser security. The path parameter can also be defined as a Request object for more advanced usage.

The second parameter, successCallback, is optional. If a function is passed, as in loadStrings('/assets/data.txt', handleData), then the handleData() function will be called once the data loads. The array created from the text data will be passed to handleData() as its only argument. The return value of the handleData() function will be used as the final return value of loadStrings('/assets/data.txt', handleData).

The third parameter, failureCallback, is also optional. If a function is passed, as in loadStrings('/assets/data.txt', handleData, handleFailure), then the handleFailure() function will be called if an error occurs while loading. The Error object will be passed to handleFailure() as its only argument. The return value of the handleFailure() function will be used as the final return value of loadStrings('/assets/data.txt', handleData, handleFailure).

This function returns a Promise and should be used in an async setup with await. See the examples for the usage syntax.