Skip to Content
DocumentationProficiency Levels

Proficiency Levels

GLOST uses a unified numeric scale (0-6) based on CEFR that maps to various proficiency standards worldwide.

The 0-6 Scale

NumericCEFRDescriptionCan-Do Summary
0Pre-A1Absolute beginnerRecognize isolated words
1A1BeginnerBasic phrases, simple questions
2A2ElementaryRoutine tasks, simple exchanges
3B1IntermediateTravel situations, connected text
4B2Upper intermediateComplex texts, fluent interaction
5C1AdvancedDemanding texts, flexible expression
6C2MasteryNative-like fluency and precision

Decimals indicate positions between levels (e.g., 2.5 = between A2 and B1).

Basic Usage

import { // CEFR conversions cefrToNumeric, numericToCEFR, // Universal conversion toNumericLevel, fromNumericLevel, // Info getProficiencyInfo, // Utilities meetsLevel, levelProgress, } from "@glotblocks/glost-common"; // CEFR ↔ Numeric cefrToNumeric("B1"); // 3 numericToCEFR(3); // "B1" numericToCEFR(2.7); // "B1" (rounds) // Universal conversion toNumericLevel("HSK 4", "hsk"); // 4 toNumericLevel("N3", "jlpt"); // 3 toNumericLevel("B2", "cefr"); // 4 fromNumericLevel(4, "hsk"); // "HSK 4" fromNumericLevel(4, "jlpt"); // "N2" fromNumericLevel(4, "cefr"); // "B2" // Proficiency info getProficiencyInfo(3); // { // numeric: 3, // cefr: "B1", // description: "B1 - Intermediate", // canDo: [ // "Deal with most situations while traveling", // "Produce simple connected text on familiar topics", // "Describe experiences, events, dreams, and ambitions" // ] // } // Utilities meetsLevel(3, 2); // true (level 3 meets requirement of 2) levelProgress(2.5, 2, 3); // 50 (50% progress from A2 to B1)

Supported Standards

CEFR (Common European Framework)

The base reference for all conversions.

LevelNumericDescription
Pre-A10Absolute beginner
A11Breakthrough
A22Waystage
B13Threshold
B24Vantage
C15Effective operational
C26Mastery
import { CEFR_LEVELS, cefrToNumeric, numericToCEFR } from "@glotblocks/glost-common"; CEFR_LEVELS; // ["Pre-A1", "A1", "A2", "B1", "B2", "C1", "C2"]

ILR (Interagency Language Roundtable)

US Government standard.

LevelNumericDescription
00No proficiency
0+0.5Memorized proficiency
11Elementary
1+1.5Elementary+
22.5Limited working
2+3.5Limited working+
34General professional
3+4.5General professional+
45Advanced professional
4+5.5Advanced professional+
56Native/bilingual
import { ILR_LEVELS, ilrToNumeric, numericToILR } from "@glotblocks/glost-common"; ilrToNumeric("3"); // 4 numericToILR(4); // "3"

ACTFL (American Council on Teaching Foreign Languages)

LevelNumeric
Novice Low0
Novice Mid0.5
Novice High1
Intermediate Low1.5
Intermediate Mid2
Intermediate High2.5
Advanced Low3
Advanced Mid3.5
Advanced High4
Superior5
Distinguished6
import { ACTFL_LEVELS, actflToNumeric, numericToACTFL } from "@glotblocks/glost-common"; actflToNumeric("Advanced Low"); // 3 numericToACTFL(3); // "Advanced Low"

HSK (Chinese - Hanyu Shuiping Kaoshi)

LevelNumericCEFR Equivalent
HSK 11A1
HSK 22A2
HSK 33B1
HSK 44B2
HSK 55C1
HSK 66C2
import { HSK_LEVELS, hskToNumeric, numericToHSK } from "@glotblocks/glost-common"; hskToNumeric("HSK 4"); // 4 numericToHSK(4); // "HSK 4"

JLPT (Japanese Language Proficiency Test)

Note: N5 is easiest, N1 is hardest.

LevelNumericCEFR Equivalent
N51A1-A2
N42A2-B1
N33B1
N24B2
N15.5C1-C2
import { JLPT_LEVELS, jlptToNumeric, numericToJLPT } from "@glotblocks/glost-common"; jlptToNumeric("N3"); // 3 numericToJLPT(3); // "N3"

TOPIK (Test of Proficiency in Korean)

LevelNumericCEFR Equivalent
TOPIK I-11A1
TOPIK I-22A2
TOPIK II-33B1
TOPIK II-44B2
TOPIK II-55C1
TOPIK II-66C2
import { TOPIK_LEVELS, topikToNumeric, numericToTOPIK } from "@glotblocks/glost-common"; topikToNumeric("TOPIK II-4"); // 4 numericToTOPIK(4); // "TOPIK II-4"

IELTS (International English Language Testing System)

BandNumericCEFR
1-3.50Pre-A1
41A1
4.5-52A2
5.53B1
6-6.54B2
7-85C1
8.5-96C2
import { ieltsToNumeric, numericToIELTS } from "@glotblocks/glost-common"; ieltsToNumeric(6.5); // 4 numericToIELTS(4); // 6.5

TOEFL iBT (Test of English as a Foreign Language)

ScoreNumericCEFR
0-310Pre-A1
32-411A1
42-712A2
72-863B1
87-1094B2
110-1145C1
115-1206C2
import { toeflToNumeric, numericToTOEFL } from "@glotblocks/glost-common"; toeflToNumeric(95); // 4 numericToTOEFL(4); // 109

Cambridge English

ExamNumericCEFR
KET2A2
PET3B1
FCE4B2
CAE5C1
CPE6C2
import { CAMBRIDGE_LEVELS, cambridgeToNumeric, numericToCambridge } from "@glotblocks/glost-common"; cambridgeToNumeric("FCE"); // 4 numericToCambridge(4); // "FCE"

DELE (Spanish)

DELE aligns directly with CEFR (A1-C2).

import { DELE_LEVELS, deleToNumeric, numericToDELE } from "@glotblocks/glost-common"; deleToNumeric("B2"); // 4 numericToDELE(4); // "B2"

DELF/DALF (French)

  • DELF: A1, A2, B1, B2
  • DALF: C1, C2
import { DELF_LEVELS, DALF_LEVELS, delfDalfToNumeric, numericToDELFDALF } from "@glotblocks/glost-common"; delfDalfToNumeric("B2"); // 4 numericToDELFDALF(5); // "C1"

Goethe-Institut (German)

CertificateNumericCEFR
Start Deutsch 11A1
Start Deutsch 22A2
Goethe-Zertifikat B13B1
Goethe-Zertifikat B24B2
Goethe-Zertifikat C15C1
Goethe-Zertifikat C26C2
import { GOETHE_LEVELS, goetheToNumeric, numericToGoethe } from "@glotblocks/glost-common"; goetheToNumeric("Goethe-Zertifikat B2"); // 4 numericToGoethe(4); // "Goethe-Zertifikat B2"

Cross-Standard Conversion

Convert between any two standards through the numeric scale:

import { hskToNumeric, numericToJLPT, numericToCEFR } from "@glotblocks/glost-common"; // HSK 4 → JLPT equivalent const level = hskToNumeric("HSK 4"); // 4 numericToJLPT(level); // "N2" numericToCEFR(level); // "B2" // Find equivalents across standards const b2Level = 4; console.log({ cefr: numericToCEFR(b2Level), // "B2" hsk: numericToHSK(b2Level), // "HSK 4" jlpt: numericToJLPT(b2Level), // "N2" topik: numericToTOPIK(b2Level), // "TOPIK II-4" cambridge: numericToCambridge(b2Level), // "FCE" ielts: numericToIELTS(b2Level), // 6.5 toefl: numericToTOEFL(b2Level), // 109 });

Utility Functions

meetsLevel

Check if a proficiency level meets a requirement:

import { meetsLevel } from "@glotblocks/glost-common"; meetsLevel(3, 2); // true (B1 meets A2 requirement) meetsLevel(3, 3); // true (B1 meets B1 requirement) meetsLevel(3, 4); // false (B1 doesn't meet B2 requirement)

levelProgress

Calculate progress between two levels:

import { levelProgress } from "@glotblocks/glost-common"; levelProgress(2.5, 2, 3); // 50 (50% from A2 to B1) levelProgress(2.0, 2, 3); // 0 (at start) levelProgress(3.0, 2, 3); // 100 (at end) levelProgress(1.5, 2, 3); // 0 (clamped - below start)

levelsBetween

Get CEFR levels between two numeric values:

import { levelsBetween } from "@glotblocks/glost-common"; levelsBetween(1, 3); // ["A1", "A2", "B1"] levelsBetween(0, 6); // ["Pre-A1", "A1", "A2", "B1", "B2", "C1", "C2"] levelsBetween(1.5, 3.5); // ["A2", "B1"]

getProficiencyInfo

Get complete information about a level:

import { getProficiencyInfo } from "@glotblocks/glost-common"; const info = getProficiencyInfo(4); // { // numeric: 4, // cefr: "B2", // description: "B2 - Upper Intermediate", // canDo: [ // "Understand complex texts on concrete and abstract topics", // "Interact with native speakers with fluency and spontaneity", // "Produce clear, detailed text on a wide range of subjects" // ] // }

Type Definitions

// Numeric level (0-6, decimals allowed) type ProficiencyLevel = number; // Standard identifiers type ProficiencyStandard = | "cefr" | "ilr" | "actfl" | "hsk" | "jlpt" | "topik" | "dele" | "delf" | "dalf" | "goethe" | "toefl" | "ielts" | "cambridge" | "numeric"; // CEFR level type type CEFRLevel = "Pre-A1" | "A1" | "A2" | "B1" | "B2" | "C1" | "C2"; // Proficiency info object interface ProficiencyInfo { numeric: ProficiencyLevel; cefr: CEFRLevel; description: string; canDo: string[]; }

Can-Do Statements

Each level has associated “can-do” statements describing typical abilities:

LevelKey Abilities
0 (Pre-A1)Recognize isolated words and very basic phrases
1 (A1)Introduce yourself, ask simple questions, handle basic transactions
2 (A2)Communicate in simple routine tasks, describe background
3 (B1)Handle travel situations, produce simple text, describe experiences
4 (B2)Understand complex texts, interact fluently, produce detailed text
5 (C1)Understand demanding texts, express fluently, use language flexibly
6 (C2)Understand virtually everything, express with precision and nuance
Last updated on