Canadian Armed Forces (CAF) Ranks

Current Version: v0.5.2

Ranks in the Canadian Armed Forces mark a person's position in its hierarchical structure. As people gain more responsibility and authority, they earn promotions in rank.

This library enables the easy reusability of the Canadian Armed Forces Ranks within your own project.

Features

• Support for both official languages (English and French)
• Static JSON document
• Typing support
• Built-in filtering methods:
  • Filter by CAF Element (Army, Air, Navy)
  • Filter by Rank Category (NCM, NCO, Junior Officer ...)

Install

This library is available using the Node Package Manager.

npm install caf-ranks

Import Into Your Project

Depending on the environment you are using, importing the library will look a little different.

// CommonJS
const { allRanks } = require("caf-ranks");

// ModernJS
import { allRanks } from "caf-ranks";

Examples

Basic Usage

import { allRanks } from "caf-ranks";

// Log all English ranks to the console
allRanks.forEach((rank) => {
  console.log(rank.title.en);
});
/*
  General
  Admiral
  Lieutenant-General
  Vice-Admiral
  Major-General
  (...)
*/

// Log all French rank abberviations to the console
allRanks.forEach((rank) => {
  console.log(rank.abbreviation.fr);
});
/*
  gén
  am
  lgén
  vam
  mgén
  (...)
*/

Filtering Ranks

import {
  allRanks,
  filterRanksByElement,
  filterRanksByCategory,
} from "caf-ranks";

// Log all English Navy ranks to the console
const navyRanks = filterRanksByElement(allRanks, "RCN");
navyRanks.forEach((rank) => {
  console.log(rank.title.en);
});
/*
  Admiral
  Vice-Admiral
  Rear-Admiral
  Commodore
  Captain(N)
  (...)
*/

// Log all French Air Force NCM ranks to the console
const airForceRanks = filterRanksByElement(allRanks, "RCAF");
const airForceNCMRanks = filterRanksByCategory(airForceRanks, "JuniorNCM");
airForceNCMRanks.forEach((rank) => {
  console.log(rank.title.fr);
});
/*
  Caporal-chef
  Caporal
  Aviateur (formé)
  Aviateur (confirmé)
*/

Using Rank Meta

import { rankMeta } from "caf-ranks";

// Log the English version of the Army element to the console
console.log(rankMeta.element.CA.en);
/*
  Canadian Army
*/

// Log the French version of the Flag Officer category to the console
console.log(rankMeta.category.FlagOfficer.fr);
/*
  Officiers généraux
*/

License

This project is licensed under the Open Government Licence - Canada 2.0

See LICENSE.md

Sources

• Tables found on Military Ranks - Canada.ca (2023-08-30)
• Tables found on Grades militaires - Canada.ca (2023-08-30)
• CSV files found on Rank Appointment Insignia - Open Government Portal