Download Latest Version v0.17.0 source code.tar.gz (4.8 MB)
Email in envelope

Get an email when there's a new version of Fury

Home / v0.17.0
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2026-04-16 17.5 kB
0
v0.17.0 source code.tar.gz 2026-04-16 4.8 MB
0
v0.17.0 source code.zip 2026-04-16 6.2 MB
0
Totals: 3 Items   11.0 MB 0

The Apache Fory team is pleased to announce the 0.17.0 release. This is a major release that includes 71 PR from 19 distinct contributors. See the Install Page to learn how to get the libraries for your platform.

JavaScript/NodeJS Serialization: First Release

Apache Fory 0.17.0 marks the first release with official JavaScript/NodeJS documentation, benchmark coverage, and TypeScript-friendly IDL code generation. The JavaScript runtime is built for modern Node.js services and TypeScript codebases, while preserving Fory's cross-language object model, schema-driven APIs, and optional reference tracking.

Key capabilities:

  • High-performance serialization for JavaScript and TypeScript objects in Node.js
  • Cross-language compatibility with Java, Python, Go, Rust, C#, Swift, and Dart
  • Schema-driven APIs via Type.* builders and TypeScript decorators
  • Optional reference tracking for shared and circular object graphs
  • Compatible mode for schema evolution
  • Configurable depth, binary size, and collection size guardrails
  • JavaScript/TypeScript target support in the Fory IDL/compiler workflow
  • Optional @apache-fory/hps fast string path for Node.js 20+

Quick Start

:::ts
import Fory, { Type } from "@apache-fory/core";

const userType = Type.struct(
  { typeName: "example.user" },
  {
    id: Type.int64(),
    name: Type.string(),
    age: Type.int32(),
  },
);

const fory = new Fory();
const { serialize, deserialize } = fory.register(userType);

const bytes = serialize({
  id: 1n,
  name: "Alice",
  age: 30,
});

const user = deserialize(bytes);
console.log(user);

JavaScript Benchmarks

Below are throughput results (ops/sec; higher is better) comparing Fory with Protocol Buffers and JSON across representative data structures.

Datatype Operation Fory TPS Protobuf TPS JSON TPS Fastest
Struct Serialize 8,453,950 1,903,706 3,058,232 fory
Struct Deserialize 9,705,287 8,233,664 3,860,538 fory
Sample Serialize 1,498,391 422,620 744,790 fory
Sample Deserialize 1,918,162 819,010 762,048 fory
MediaContent Serialize 1,293,157 729,497 1,299,908 json
MediaContent Deserialize 1,638,086 1,209,140 921,191 fory
StructList Serialize 3,928,325 495,648 891,810 fory
StructList Deserialize 3,264,827 1,529,744 986,144 fory
SampleList Serialize 355,581 92,741 163,120 fory
SampleList Deserialize 424,916 163,253 162,520 fory
MediaContentList Serialize 286,053 148,977 282,445 fory
MediaContentList Deserialize 376,826 244,622 190,155 fory

Serialized data sizes (bytes):

Datatype Fory Protobuf JSON
Struct 58 61 103
Sample 446 377 724
MediaContent 391 307 596
StructList 184 315 537
SampleList 1980 1900 3642
MediaContentList 1665 1550 3009

Benchmark details: https://github.com/apache/fory/tree/v0.17.0/benchmarks/javascript

Dart Serialization: First Release

Apache Fory 0.17.0 also marks the first release with official Dart documentation, benchmark coverage, a rebuilt runtime, and Dart IDL support. The Dart implementation focuses on generated serializers, stable cross-language type identity, schema evolution, and predictable APIs for service workloads.

Key capabilities:

  • High-performance Dart serialization with generated code instead of reflection
  • Cross-language compatibility with Java, Python, Go, Rust, C#, Swift, and JavaScript
  • @ForyStruct and @ForyField annotations with build_runner code generation
  • Compatible mode for schema evolution across versions
  • Optional reference tracking for shared and circular object graphs
  • Manual Serializer<T> extension points for advanced or custom types
  • Dart target support in the Fory IDL/compiler workflow

Quick Start

:::dart
import 'package:fory/fory.dart';

part 'person.fory.dart';

enum Color {
  red,
  blue,
}

@ForyStruct()
class Person {
  Person();

  String name = '';
  Int32 age = Int32(0);
  Color favoriteColor = Color.red;
}

void main() {
  final fory = Fory();
  PersonFory.register(
    fory,
    Color,
    namespace: 'example',
    typeName: 'Color',
  );
  PersonFory.register(
    fory,
    Person,
    namespace: 'example',
    typeName: 'Person',
  );

  final bytes = fory.serialize(Person()
    ..name = 'Ada'
    ..age = Int32(36)
    ..favoriteColor = Color.blue);
  final roundTrip = fory.deserialize<Person>(bytes);
  print(roundTrip.name);
}

Dart Benchmarks

Below are throughput results (ops/sec; higher is better) comparing Fory with Protocol Buffers across representative data structures.

Datatype Operation Fory TPS Protobuf TPS Fastest
Struct Serialize 3,989,432 1,884,653 fory (2.12x)
Struct Deserialize 5,828,197 4,199,680 fory (1.39x)
Sample Serialize 1,649,722 500,167 fory (3.30x)
Sample Deserialize 2,060,113 785,109 fory (2.62x)
MediaContent Serialize 800,876 391,235 fory (2.05x)
MediaContent Deserialize 1,315,115 683,533 fory (1.92x)
StructList Serialize 1,456,396 367,506 fory (3.96x)
StructList Deserialize 1,921,006 645,958 fory (2.97x)
SampleList Serialize 411,144 48,508 fory (8.48x)
SampleList Deserialize 464,273 103,558 fory (4.48x)
MediaContentList Serialize 186,870 77,029 fory (2.43x)
MediaContentList Deserialize 330,293 128,215 fory (2.58x)

Serialized data sizes (bytes):

Datatype Fory Protobuf
Struct 58 61
Sample 446 377
MediaContent 365 307
StructList 184 315
SampleList 1980 1900
MediaContentList 1535 1550

Benchmark details: https://github.com/apache/fory/tree/v0.17.0/benchmarks/dart

Highlights

Features

Bug Fix

Other Improvements

New Contributors

Full Changelog: https://github.com/apache/fory/compare/v0.16.0...v0.17.0

Source: README.md, updated 2026-04-16