native-errors

Библиотека OneScript для нормализации исключений встроенных объектов. Она содержит каталог нативных кодов и правил, а классификацию выполняет через errors.

Поддерживаются, в частности, файловая система, процессы, потоки, JSON, XML, текст, двоичные данные и HTTP, включая ошибки сети, прокси и TLS. Полный перечень кодов, их назначение и область применения приведены в КодахНативныхОшибок.

Установка

opm install native-errors

Требуется OneScript 2.0 или новее.

Быстрый старт

#Использовать errors
#Использовать native-errors

Классификатор = Новый КлассификаторОшибок;
Классификатор.ДобавитьПоставщикаПравил(Тип("ПравилаНативныхОшибок"));

Попытка
	Чтение = Новый ЧтениеJSON;
	Чтение.Прочитать();
Исключение
	Ошибка = Классификатор.Классифицировать(ИнформацияОбОшибке());
	Если Ошибка <> Неопределено Тогда
		Сообщить(ДиагностикаОшибок.КодОшибки(Ошибка)); // Будет выведено: `json.reader.not_open`
	КонецЕсли;
КонецПопытки;

Правила распознают известные сигнатуры нативных исключений OneScript. Ошибка прикладного кода, внешней библиотеки или нативная ошибка с неподходящей сигнатурой может остаться нераспознанной: тогда КлассификаторОшибок вернет Неопределено. Наличие кода в каталоге не означает, что будет распознана любая ошибка со сходным смыслом.

Публичный API

• ПравилаНативныхОшибок
• КодыНативныхОшибок

Разработка

Установить зависимости разработки:

opm install -l --dev

Установить OneUnit и BenchmarkOneScript при необходимости:

opm install oneunit
opm install benchmark

Запустить тесты:

oneunit execute

Запустить бенчмарки:

benchos run .\benchmarks

Собрать пакет:

opm build .