d3-fetch

Этот модуль предоставляет удобный синтаксический разбор на основе Fetch. Например, для загрузки текстового файла:

d3.text("/path/to/file.txt").then(function(text) {
  console.log(text); // Hello, world!
});

Для загрузки и разбора файла CSV:

d3.csv("/path/to/file.csv").then(function(data) {
  console.log(data); // [{"Hello": "world"}, …]
});

Этот модуль имеет встроенную поддержку разбора JSON, CSV и TSV. Вы можете добавить поддержку других форматов, используя text напрямую. (Этот модуль заменил d3-request.)

Установка

Если вы используете NPM, npm install d3-fetch. В противном случае загрузите последнюю версию. Вы также можете загрузить его напрямую с d3js.org как отдельную библиотеку. Поддерживаются AMD, CommonJS и обычные среды. В обычных средах экспортируется глобальная переменная d3:

<script src="https://d3js.org/d3-dsv.v2.min.js"></script>
<script src="https://d3js.org/d3-fetch.v2.min.js"></script>
<script>

d3.csv("/path/to/file.csv").then(function(data) {
  console.log(data); // [{"Hello": "world"}, …]
});

</script>

Справочник по API

d3.blob(input[, init]) Исходный код

Загружает двоичный файл по указанному URL-адресу input в формате Blob. Если init указан, он передается в вызов fetch; см. RequestInit для допустимых полей.

d3.buffer(input[, init]) Исходный код

Загружает двоичный файл по указанному URL-адресу input в формате ArrayBuffer. Если init указан, он передается в вызов fetch; см. RequestInit для допустимых полей.

d3.csv(input[, init][, row]) Исходный код

Эквивалентно d3.dsv с запятой в качестве разделителя.

d3.dsv(delimiter, input[, init][, row]) Исходный код

Загружает файл DSV по указанному URL-адресу input. Если init указан, он передается в вызов fetch; см. RequestInit для допустимых полей. Можно указать необязательную функцию преобразования row для отображения и фильтрации объектов строк до более конкретного представления; см. dsv.parse для получения подробностей. Например:

d3.dsv(",", "test.csv", function(d) {
  return {
    year: new Date(+d.Year, 0, 1), // convert "Year" column to Date
    make: d.Make,
    model: d.Model,
    length: +d.Length // convert "Length" column to number
  };
}).then(function(data) {
  console.log(data);
});

Если указан только один из init и row, он интерпретируется как функция преобразования row, если это функция, и иначе как объект init.

См. также d3.csv и d3.tsv.

d3.html(input[, init]) Исходный код

Загружает файл по указанному URL-адресу input как текст, а затем парсит его как HTML. Если init указан, он передается в вызов fetch; см. RequestInit для допустимых полей.

d3.image(input[, init]) Исходный код

Загружает изображение по указанному URL-адресу input. Если init указан, устанавливает дополнительные свойства изображения перед загрузкой. Например, чтобы разрешить анонимный запрос с другого домена:

d3.image("https://example.com/test.png", {crossOrigin: "anonymous"}).then(function(img) {
  console.log(img);
});

d3.json(input[, init]) Исходный код

Загружает файл JSON по указанному URL-адресу input. Если init указан, он передается в вызов fetch; см. RequestInit для допустимых полей. Если сервер возвращает код состояния 204 Без содержимого или 205 Сброс содержимого, обещание выполняется с undefined.

d3.svg(input[, init]) Исходный код

Загружает файл по указанному URL-адресу input как текст, а затем парсит его как SVG. Если init указан, он передается в вызов fetch; см. RequestInit для допустимых полей.

d3.text(input[, init]) Исходный код

Загружает текстовый файл по указанному URL-адресу input. Если init указан, он передается в вызов fetch; см. RequestInit для допустимых полей.

d3.tsv(input[, init][, row]) Исходный код

Эквивалентно d3.dsv с символом табуляции в качестве разделителя.

d3.xml(input[, init]) Исходный код

Загружает файл по указанному URL-адресу input как текст, а затем парсит его как XML. Если init указан, он передается в вызов fetch; см. RequestInit для допустимых полей.