Skip to main content
Deno 2 is finally here 🎉️
Learn more
Go to Latest
The Standard Library has been moved to JSR. See the blog post for details.
function unicodeWidth
import { unicodeWidth } from "https://deno.land/std@0.218.0/console/unicode_width.ts";

Get the width of a string's constituent characters in columns in TTY-like environments.

Combine with stripAnsiCode from fmt/colors.ts to get the expected physical width of a string in the console.

Examples

Example 1

import { unicodeWidth } from "https://deno.land/std@0.218.0/console/unicode_width.ts";
import { assertEquals } from "https://deno.land/std@0.218.0/assert/assert_equals.ts";
import { stripAnsiCode } from "https://deno.land/std@0.218.0/fmt/colors.ts";

assertEquals(unicodeWidth("hello world"), 11);
assertEquals(unicodeWidth("天地玄黃宇宙洪荒"), 16);
assertEquals(unicodeWidth("fullwidth"), 18);
assertEquals(unicodeWidth(stripAnsiCode("\x1b[36mголубой\x1b[39m")), 7);
assertEquals(unicodeWidth(stripAnsiCode("\x1b[31m紅色\x1b[39m")), 4);
assertEquals(unicodeWidth(stripAnsiCode("\x1B]8;;https://deno.land\x07🦕\x1B]8;;\x07")), 2);

Parameters

str: string

Returns

number