transformText

ArrayBuffer をテキストに変換します。エンコーディングを自動で判別してデコードします。

API

transformText

戻り値

引数	説明	型
`TransformText \| undefined`	変換結果のオブジェクト、または undefined	`TransformText \| undefined`

TransformText

プロパティ	説明	型
`encoding`	判別されたエンコーディング	`string`
`content`	デコード後のテキスト	`string`

パラメーター

パラメーター	説明	型	既定値
`content`	変換する中身	`string \| ArrayBuffer`	必須

使用例

基本的な使い方

import { transformText } from 'ranuts';

const arrayBuffer = new TextEncoder().encode('Hello World').buffer;
const result = transformText(arrayBuffer);
if (result) {
  console.log('エンコーディング:', result.encoding);
  console.log('中身:', result.content); // 'Hello World'
}

ファイルを処理する

import { transformText } from 'ranuts';

async function readTextFile(file) {
  const arrayBuffer = await file.arrayBuffer();
  const result = transformText(arrayBuffer);
  if (result) {
    return result.content;
  }
  return null;
}

エンコーディングの自動判別

import { transformText } from 'ranuts';

// エンコーディングを自動で判別してデコードする
const result = transformText(arrayBuffer);
if (result) {
  console.log(`${result.encoding} でデコードできました`);
  console.log(result.content);
}

補足

自動で判別：jschardet を使ってエンコーディングを自動で判別します。
ArrayBuffer のみ：いまのところ ArrayBuffer にしか対応しておらず、文字列を渡すと警告が出ます。
結果が返る条件：エンコーディングが判別でき、デコードに成功したときだけ結果を返します。そうでなければ undefined です。
使いどころ：ファイルの読み込み、テキストのデコード、エンコーディングの変換などでよく使われます。