getLastElementOfArray

Возвращает последний элемент индексного массива когда этот массив не пустой. Если же массив пустой то:

• Будет брошено исключение UnexpectedEventError, если указан 2-ой параметр со значением { mustThrowErrorIfArrayIsEmpty: true }. При этом TypeScript будет считать, что если функция отработает без ошибок, а указанный явно или неявно тип элементов не может принимать значения null и/или undefined, то возвращаемое значение тоже не может быть null или undefined.
• Будет возвращён null, если 2-ого параметра не указано. В этом случае при строгих настройках TypeScript обяжет проверить возвращаемое значение на null, прежде чем использовать его.

Данная функция не просто заменяет выражения типа targetArray[targetArray.length - 1], но и позволяет гарантировать, что последний элемент массива существует.

Примеры

const sample: Array<string> = [ "alpha", "bravo", "charlie" ];

const lastElementOfSample: string | null = getLastElementOfArray(sample);

console.log(lastElementOfSample.length);

const notNullLastElementOfSample: string = getLastElementOfArray(sample, { mustThrowErrorIfArrayIsEmpty: true });

Быстрый ввод в интегрированных средах разработки семейства IntelliJ IDEA

Использование Live template-ов в семействе интегрированных сред разработки IntelliJ IDEA позволяет вводить код такой так выражения вызова функции быстрее. Для получения доступа к Live Template-ам библиотеки YDEE потребуется установить официальный плагин этой библиотеки.

Пошаговое описание процесса использования шаблона

Если Вы ранее не пользовались Live template-ами, то пусть Вас не пугает приведённая ниже объёмная инструкция: при сформированной привычке использования Live template-ов (эта привычка сходна с повседневным применением сочетаний клавиш) скорость выполнения описанных ниже операций займёт считанные секунды.

1. Скопируйте в буфер обмен имя переменной, содержащей массив, либо само выражение массива. Чтобы среда разработки смогла автоматически заполнить позицию первого параметра нужным значением, сформируйте привычку делать это копирование перед тем, как начинать вводить Live template функции getLastElementOfArray.
2. Начните набирать имя функции — addElementsToArray. Подсветится 2 варианта автодополнения:
   1. Иконка тремя наложенных друг на друга разноцветными кругами - это просто автодополнение имени функции; стандартная функциональность среды разработки. Нажатие на Enter введёт полное имя функции, а также при необходимости объявления импорта этой функции. Неплохо, однако это не предел, до которого можно частично автоматизировать процесс.
   2. Иконка с клише — это как раз нужный шаблон. Нажмите Enter. Произойдёт вставка шаблона кода, при этом первого параметра targetArray будет автоматически выделено и заполнено содержимым буфера обмена. Поскольку при следовании данному руководству менять подставленное значение параметра на другое не требуется, выйдете из режима редактирования параметра, нажав Enter ещё раз.
3. Удалите лишний код.

Вы можете использовать алиас этого LiveTemplate-а — gleoa, состоящий из первых букв всех слов, которые включает в себя имя функции. Однако недостаток таких алиасов в том, что их приходится запоминать, а для того, чтобы получить подсказку getLastElementOfArray, достаточно лишь помнить, с чего начинается это имя функции.

Внешние ссылки

• Исходный код
• Код тестов