297 lines
11 KiB
JavaScript
297 lines
11 KiB
JavaScript
/*
|
|
* (c) Copyright Ascensio System SIA 2010-2025
|
|
*
|
|
* This program is a free software product. You can redistribute it and/or
|
|
* modify it under the terms of the GNU Affero General Public License (AGPL)
|
|
* version 3 as published by the Free Software Foundation. In accordance with
|
|
* Section 7(a) of the GNU AGPL its Section 15 shall be amended to the effect
|
|
* that Ascensio System SIA expressly excludes the warranty of non-infringement
|
|
* of any third-party rights.
|
|
*
|
|
* This program is distributed WITHOUT ANY WARRANTY; without even the implied
|
|
* warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. For
|
|
* details, see the GNU AGPL at: http://www.gnu.org/licenses/agpl-3.0.html
|
|
*
|
|
* You can contact Ascensio System SIA at 20A-6 Ernesta Birznieka-Upish
|
|
* street, Riga, Latvia, EU, LV-1050.
|
|
*
|
|
* The interactive user interfaces in modified source and object code versions
|
|
* of the Program must display Appropriate Legal Notices, as required under
|
|
* Section 5 of the GNU AGPL version 3.
|
|
*
|
|
* Pursuant to Section 7(b) of the License you must retain the original Product
|
|
* logo when distributing the program. Pursuant to Section 7(e) we decline to
|
|
* grant you any rights under trademark law for use of our trademarks.
|
|
*
|
|
* All the Product's GUI elements, including illustrations and icon sets, as
|
|
* well as technical writing content are licensed under the terms of the
|
|
* Creative Commons Attribution-ShareAlike 4.0 International. See the License
|
|
* terms at http://creativecommons.org/licenses/by-sa/4.0/legalcode
|
|
*
|
|
*/
|
|
|
|
const {describe, test, expect} = require('@jest/globals');
|
|
const sharp = require('./../../DocService/node_modules/sharp');
|
|
const operationContext = require('./../../Common/sources/operationContext');
|
|
const utilsDocService = require('./../../DocService/sources/utilsDocService');
|
|
|
|
describe('utilsDocService image processing', () => {
|
|
const ctx = operationContext.global;
|
|
|
|
describe('determineOptimalFormat', () => {
|
|
test('should choose PNG for images with alpha channel', () => {
|
|
const metadata = {
|
|
hasAlpha: true,
|
|
width: 400,
|
|
height: 300,
|
|
channels: 4
|
|
};
|
|
|
|
const format = utilsDocService.determineOptimalFormat(ctx, metadata);
|
|
expect(format).toBe('png');
|
|
});
|
|
|
|
test('should choose PNG for small images (icons/logos)', () => {
|
|
const metadata = {
|
|
hasAlpha: false,
|
|
width: 128,
|
|
height: 128,
|
|
channels: 3
|
|
};
|
|
|
|
const format = utilsDocService.determineOptimalFormat(ctx, metadata);
|
|
expect(format).toBe('png');
|
|
});
|
|
|
|
test('should choose JPEG for large images', () => {
|
|
const metadata = {
|
|
hasAlpha: false,
|
|
width: 1200,
|
|
height: 800,
|
|
channels: 3
|
|
};
|
|
|
|
const format = utilsDocService.determineOptimalFormat(ctx, metadata);
|
|
expect(format).toBe('jpeg');
|
|
});
|
|
|
|
test('should choose PNG for exact small image boundary (256x256)', () => {
|
|
const metadata = {
|
|
hasAlpha: false,
|
|
width: 256,
|
|
height: 256,
|
|
channels: 3
|
|
};
|
|
|
|
const format = utilsDocService.determineOptimalFormat(ctx, metadata);
|
|
expect(format).toBe('png');
|
|
});
|
|
|
|
test('should choose JPEG for exact large image boundary (800x600)', () => {
|
|
const metadata = {
|
|
hasAlpha: false,
|
|
width: 800,
|
|
height: 600,
|
|
channels: 3
|
|
};
|
|
|
|
const format = utilsDocService.determineOptimalFormat(ctx, metadata);
|
|
expect(format).toBe('jpeg');
|
|
});
|
|
|
|
test('should choose JPEG as default when no specific conditions match', () => {
|
|
const metadata = {
|
|
hasAlpha: false,
|
|
width: 400,
|
|
height: 300,
|
|
channels: 3
|
|
};
|
|
|
|
const format = utilsDocService.determineOptimalFormat(ctx, metadata);
|
|
expect(format).toBe('jpeg');
|
|
});
|
|
});
|
|
|
|
describe('processImageOptimal', () => {
|
|
test('should handle EXIF rotation and WebP conversion to JPEG for large images', async () => {
|
|
// Create a large WebP image with EXIF orientation that should be converted to JPEG
|
|
const webpImage = await sharp({
|
|
create: {width: 1000, height: 600, channels: 3, background: {r: 100, g: 150, b: 200}}
|
|
})
|
|
.composite([
|
|
{
|
|
input: await sharp({
|
|
create: {width: 200, height: 120, channels: 3, background: {r: 200, g: 100, b: 50}}
|
|
})
|
|
.png()
|
|
.toBuffer(),
|
|
top: 100,
|
|
left: 200
|
|
}
|
|
])
|
|
.withMetadata({orientation: 6}) // rotate 90 degrees
|
|
.webp()
|
|
.toBuffer();
|
|
|
|
const result = await utilsDocService.processImageOptimal(ctx, webpImage);
|
|
const metadata = await sharp(result).metadata();
|
|
|
|
expect(metadata.format).toBe('jpeg');
|
|
expect(Buffer.compare(webpImage, result) !== 0).toBe(true);
|
|
});
|
|
|
|
test('should handle EXIF rotation and WebP conversion to PNG for small images', async () => {
|
|
// Create a small WebP image with EXIF orientation that should be converted to PNG
|
|
const webpImage = await sharp({
|
|
create: {width: 100, height: 100, channels: 3, background: {r: 255, g: 255, b: 255}}
|
|
})
|
|
.withMetadata({orientation: 3}) // rotate 180 degrees
|
|
.webp()
|
|
.toBuffer();
|
|
|
|
const result = await utilsDocService.processImageOptimal(ctx, webpImage);
|
|
const metadata = await sharp(result).metadata();
|
|
|
|
expect(metadata.format).toBe('png');
|
|
expect(Buffer.compare(webpImage, result) !== 0).toBe(true);
|
|
});
|
|
|
|
test('should handle EXIF rotation and TIFF conversion to optimal format', async () => {
|
|
// Create a medium-sized TIFF image with EXIF orientation (should use JPEG)
|
|
const tiffImage = await sharp({
|
|
create: {width: 900, height: 600, channels: 3, background: {r: 255, g: 255, b: 255}}
|
|
})
|
|
.withMetadata({orientation: 8}) // rotate 270 degrees
|
|
.tiff()
|
|
.toBuffer();
|
|
|
|
const result = await utilsDocService.processImageOptimal(ctx, tiffImage);
|
|
const metadata = await sharp(result).metadata();
|
|
|
|
expect(metadata.format).toBe('jpeg'); // large image should use JPEG
|
|
expect(Buffer.compare(tiffImage, result) !== 0).toBe(true);
|
|
});
|
|
|
|
test('should handle EXIF rotation for standard JPEG without format conversion', async () => {
|
|
// Create a JPEG image with EXIF orientation
|
|
const jpegImage = await sharp({
|
|
create: {width: 400, height: 300, channels: 3, background: {r: 255, g: 100, b: 50}}
|
|
})
|
|
.withMetadata({orientation: 6}) // rotate 90 degrees
|
|
.jpeg()
|
|
.toBuffer();
|
|
|
|
const result = await utilsDocService.processImageOptimal(ctx, jpegImage);
|
|
const metadata = await sharp(result).metadata();
|
|
|
|
expect(metadata.format).toBe('jpeg');
|
|
expect(Buffer.compare(jpegImage, result) !== 0).toBe(true);
|
|
});
|
|
|
|
test('should not modify images without EXIF rotation and unsupported formats', async () => {
|
|
// Create a standard PNG without EXIF orientation
|
|
const pngImage = await sharp({
|
|
create: {width: 400, height: 300, channels: 3, background: {r: 255, g: 255, b: 255}}
|
|
})
|
|
.png()
|
|
.toBuffer();
|
|
|
|
const result = await utilsDocService.processImageOptimal(ctx, pngImage);
|
|
|
|
expect(Buffer.compare(pngImage, result) === 0).toBe(true);
|
|
});
|
|
|
|
test('should handle WebP with transparency (alpha channel)', async () => {
|
|
// Create WebP with alpha channel - should convert to PNG
|
|
const webpImage = await sharp({
|
|
create: {width: 400, height: 300, channels: 4, background: {r: 255, g: 255, b: 255, alpha: 0.5}}
|
|
})
|
|
.webp()
|
|
.toBuffer();
|
|
|
|
const result = await utilsDocService.processImageOptimal(ctx, webpImage);
|
|
const metadata = await sharp(result).metadata();
|
|
|
|
expect(metadata.format).toBe('png'); // alpha channel should force PNG
|
|
expect(metadata.hasAlpha).toBe(true);
|
|
});
|
|
|
|
test('should handle HEIC conversion to optimal format', async () => {
|
|
// Note: Sharp may not support HEIC creation, so this test might need adjustment
|
|
// For now testing the code path exists
|
|
const mockHeicBuffer = Buffer.from('mock-heic-data');
|
|
|
|
// Test doesn't crash with invalid HEIC data
|
|
const result = await utilsDocService.processImageOptimal(ctx, mockHeicBuffer);
|
|
expect(result).toEqual(mockHeicBuffer); // Should return original on error
|
|
});
|
|
|
|
test('should handle corrupted image data gracefully', async () => {
|
|
const corruptedBuffer = Buffer.from('not-an-image');
|
|
|
|
const result = await utilsDocService.processImageOptimal(ctx, corruptedBuffer);
|
|
expect(result).toEqual(corruptedBuffer); // Should return original on error
|
|
});
|
|
|
|
test('should handle null input', async () => {
|
|
const result = await utilsDocService.processImageOptimal(ctx, null);
|
|
expect(result).toBeNull();
|
|
});
|
|
|
|
test('should handle empty buffer', async () => {
|
|
const emptyBuffer = Buffer.alloc(0);
|
|
const result = await utilsDocService.processImageOptimal(ctx, emptyBuffer);
|
|
expect(result).toEqual(emptyBuffer);
|
|
});
|
|
|
|
test('should produce valid JPEG output with reasonable quality', async () => {
|
|
// Create a large WebP that should convert to JPEG
|
|
const webpImage = await sharp({
|
|
create: {width: 1000, height: 600, channels: 3, background: {r: 100, g: 150, b: 200}}
|
|
})
|
|
.webp()
|
|
.toBuffer();
|
|
|
|
const result = await utilsDocService.processImageOptimal(ctx, webpImage);
|
|
const metadata = await sharp(result).metadata();
|
|
|
|
expect(metadata.format).toBe('jpeg');
|
|
expect(metadata.width).toBe(1000);
|
|
expect(metadata.height).toBe(600);
|
|
// JPEG should be a reasonable size (not empty, but also not excessively large)
|
|
expect(result.length).toBeGreaterThan(1000); // Not too compressed
|
|
expect(result.length).toBeLessThan(500000); // Not excessively large for 1000x600
|
|
});
|
|
|
|
test('should produce smaller PNG than uncompressed for simple graphics', async () => {
|
|
// Create a TIFF with simple graphics that should convert to PNG
|
|
const tiffImage = await sharp({
|
|
create: {width: 200, height: 150, channels: 3, background: {r: 255, g: 255, b: 255}}
|
|
})
|
|
.composite([
|
|
{
|
|
input: await sharp({
|
|
create: {width: 50, height: 50, channels: 3, background: {r: 255, g: 0, b: 0}}
|
|
})
|
|
.png()
|
|
.toBuffer(),
|
|
top: 50,
|
|
left: 75
|
|
}
|
|
])
|
|
.tiff()
|
|
.toBuffer();
|
|
|
|
const result = await utilsDocService.processImageOptimal(ctx, tiffImage);
|
|
const metadata = await sharp(result).metadata();
|
|
|
|
expect(metadata.format).toBe('png'); // small image should use PNG
|
|
expect(metadata.width).toBe(200);
|
|
expect(metadata.height).toBe(150);
|
|
// PNG should be compressed but reasonable size
|
|
expect(result.length).toBeGreaterThan(500);
|
|
expect(result.length).toBeLessThan(100000); // Should be well compressed
|
|
});
|
|
});
|
|
});
|