Convert Data Types

Each ScriptRunner Connect workspace includes the @sr-connect/convert package, which provides a set of convenient functions for converting between different data types:

• convertBase64ToBuffer - Converts a base64 encoded string into an ArrayBuffer.
• convertBase64ToText - Converts a base64 encoded string into plain text.
• convertBufferToBase64 - Converts an ArrayBuffer into a base64 encoded string.
• convertBufferToText - Converts an ArrayBuffer into plain text.
• convertTextToBase64 - Converts plain text into a base64 encoded string.
• convertTextToBuffer - Converts plain text into an ArrayBuffer.
• convertTextToText - Converts plain text to plain text with a different encoding.
• convertArrayBufferToFormDataBuffer - Converts an ArrayBuffer into a form-data-encoded ArrayBuffer, offering a more efficient solution than using FormData and Blob classes separately (strongly recommended). Read more about it in the "Working with Attachments" topic.

Using the functions in your workspace

To use these functions, you need to import them into your script first.

You can import each function separately as follows:

js
import { convertTextToBase64 } from '@sr-connect/convert';

export default async function(event: any, context: Context): Promise<void> {
	console.log(convertTextToBase64('HELLO WORLD', 'utf8'));
}

Or you can import the entire namespace as follows:

js
import { Convert } from '@sr-connect/convert';

export default async function(event: any, context: Context): Promise<void> {
	console.log(Convert.textToBase64('HELLO WORLD', 'utf8'));
}