Реклама мешает? Идти Без рекламы Сегодня 

Конвертер VCF (файл vCard) в JSON

ДанныеРазработчикТекст

[iotools_vcf_vcard_to_json_converter]

Гид

Конвертер VCF (файл vCard) в JSON

Преобразует любой экспорт адресной книги в чистый, структурированный массив контактов в формате JSON. Конвертер полностью парсит файлы vCard 3.0 (RFC 2426) и vCard 4.0 (RFC 6350) прямо в вашем браузере, обрабатывает обязательные по RFC правила сгибания строк, файлы с несколькими контактами, структурированные значения имени и адреса, параметры с несколькими типами и даже закодированные в base64 фотографии и логотипы. Используйте его для миграции контактов в CRM, подачи данных в автоматизацию или просто для того, чтобы посмотреть, что содержит файл контактов.

Как использовать

Вставьте содержимое вашего файла .vcf в поле ввода или загрузите файл с помощью элемента выбора файла.
Выберите параметры вывода — красиво отформатированный JSON, плоский массив или вложенный объект, структурированное разделение имени и адреса, парсинг дат в формате ISO для BDAY/REV/ANNIVERSARY, группировка EMAIL и TEL по типу и включение данных в формате base64 PHOTO/LOGO.
Площадка с результатом в формате JSON обновляется автоматически при вводе текста или при изменении параметров.
Нажмите «Скопировать», чтобы поместить JSON на буфер обмена, или «Скачать», чтобы сохранить его как contacts.json.

Возможности

Поддержка vCard 3.0 и 4.0 — Принимает как современный синтаксис (TYPE=), так и устаревший синтаксис (HOME;VOICE) из vCard 2.1.
Разделение строк по RFC 6350 — Правильно восстанавливает длинные строки, разбитые на несколько физических строк с CRLF и пробелом перед парсингом.
Структурированное разделение имени — Свойство N разбивается на поля: фамилия, имя, дополнительное, префикс и суффикс, при этом подсписки, разделённые запятыми, сохраняются как массивы.
Структурированное разделение адреса — Свойство ADR разбивается на поля: пост-офис, расширенный адрес, улица, район, регион, почтовый индекс и страна.
Файлы с несколькими контактами — Один файл .vcf, содержащий множество блоков BEGIN:VCARD, генерирует один объект JSON на каждый контакт.
Поддержка base64 PHOTO / LOGO / KEY — Встроенные данные в формате base64 восстанавливаются как URI data: при включении опции «Включить данные PHOTO/LOGO в формате base64», или суммируются с указанием размера, если опция отключена.
Порядок PREF — Многозначные поля EMAIL, TEL, ADR и URL сортируются по параметру PREF, чтобы предпочтительный элемент оказался первым.
Группировка по типу — Опционально группирует поля EMAIL, TEL, ADR и URL в типовые категории (работа, домашний, мобильный и т.д.) для прямого доступа по словарному стилю.
Парсинг дат по стандарту ISO 8601 — Значения BDAY, ANNIVERSARY и REV нормализуются в строки формата ISO 8601.
Парсер с поддержкой DQUOTE — Запятые и точки с запятой внутри кавычек сохраняются буквально.
100% клиентская сторона — Файл .vcf никогда не покидает ваш браузер. Нет загрузки, нет обработки на сервере, нет вопросов касательно приватности.
Опциональный исходный вывод — Включает исходное значение свойства вместе с распарсенным значением для отладки или для обратной связи.

 Часто задаваемые вопросы

Что такое сгибание строк в vCard?

RFC 6350 позволяет длинные строки свойств разбивать на несколько физических строк, вставляя CRLF, за которым следует один пробел (пробел или табуляция). При парсинге разрыв строки и ведущий пробел удаляются для восстановления исходной логической строки. Именно поэтому простое разбиение строки построчно при парсинге vCard-файлов часто приводит к повреждению длинных заметок или закодированных в base64 фотографий.
Как vCard 3.0 и 4.0 различаются по значениям параметров?

vCard 3.0 (RFC 2426) и более ранние версии 2.1 часто используют несколько параметров TYPE или синтаксис без типа, например TEL;HOME;VOICE:.... vCard 4.0 (RFC 6350) предпочитает один параметр TYPE с перечислением значений через запятую и использует URI-значения (tel:, mailto:, data:) вместо встроенной кодировки. Устойчивый парсер должен принимать оба формата и нормализовать их.
Что такое структурированное значение в vCard?

Свойства, такие как N (Имя) и ADR (Адрес), содержат несколько подполей, соединённых точками с запятой. N имеет пять компонентов — фамилия, имя, дополнительное, префикс и суффикс — и ADR имеет семь — пост-офис, расширенный адрес, улица, район, регион, почтовый индекс и страна. Каждый компонент может быть списком, разделённым запятыми. Разделение должно учитывать последовательность экранирования, чтобы экранированные точки с запятой в значении не воспринимались как разделители.
Почему свойство PHOTO содержит данные в формате base64?

vCard 3.0 встраивает двоичные данные, такие как портреты, логотипы и ключи, с помощью кодирования в base64 и указывает на кодирование через параметр ENCODING=B. vCard 4.0 вместо этого использует URIs data: с префиксом типа медиа. Оба формата могут создавать очень длинные строки, что является основной причиной того, что RFC 6350 требует сгибания строк при передаче.