mediawiki-extensions-Multim.../resources/mmv/provider/mmv.provider.ImageInfo.js
Simon Legner f00dbbb939 Remove IIFE
Remove Immediately-invoked function expression throughout production code base.

Bug: T77349
Change-Id: Ia31b556975209bbea27df8444b69d924654b181e
2024-05-21 22:31:15 +02:00

120 lines
3.1 KiB
JavaScript

/*
* This file is part of the MediaWiki extension MultimediaViewer.
*
* MultimediaViewer is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 2 of the License, or
* (at your option) any later version.
*
* MultimediaViewer is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with MultimediaViewer. If not, see <http://www.gnu.org/licenses/>.
*/
const Api = require( './mmv.provider.Api.js' );
const ImageModel = require( '../model/mmv.model.Image.js' );
/**
* Gets file information.
*
* See https://www.mediawiki.org/wiki/API:Properties#imageinfo_.2F_ii
*/
class ImageInfo extends Api {
/**
* @param {mw.Api} api
* @param {Object} [options]
* @cfg {string} [language=null] image metadata language
* @cfg {number} [maxage] cache expiration time, in seconds
* Will be used for both client-side cache (maxage) and reverse proxies (s-maxage)
*/
constructor( api, options ) {
options = Object.assign( {
language: null
}, options );
super( api, options );
}
/**
* Array of imageinfo API properties which are needed to construct an Image model.
*
* @return {string[]}
*/
get iiprop() {
return [
'timestamp',
'url',
'size',
'mime',
'mediatype',
'extmetadata'
];
}
/**
* Array of imageinfo extmetadata fields which are needed to construct an Image model.
*
* @return {string[]}
*/
get iiextmetadatafilter() {
return [
'DateTime',
'DateTimeOriginal',
'ObjectName',
'ImageDescription',
'License',
'LicenseShortName',
'UsageTerms',
'LicenseUrl',
'Credit',
'Artist',
'AuthorCount',
'GPSLatitude',
'GPSLongitude',
'Permission',
'Attribution',
'AttributionRequired',
'NonFree',
'Restrictions',
'DeletionReason'
];
}
/**
* Runs an API GET request to get the image info.
*
* @param {mw.Title} file
* @return {jQuery.Promise} a promise which resolves to an Image object.
*/
get( file ) {
return this.getCachedPromise( file.getPrefixedDb(), () => {
return this.apiGetWithMaxAge( {
formatversion: 2,
action: 'query',
prop: 'imageinfo',
titles: file.getPrefixedDb(),
iiprop: this.iiprop,
iiextmetadatafilter: this.iiextmetadatafilter,
iiextmetadatalanguage: this.options.language,
uselang: 'content'
} ).then( ( data ) => {
return this.getQueryPage( data );
} ).then( ( page ) => {
if ( page.imageinfo && page.imageinfo.length ) {
return ImageModel.newFromImageInfo( file, page );
} else if ( page.missing === true && page.imagerepository === '' ) {
return $.Deferred().reject( `file does not exist: ${ file.getPrefixedDb() }` );
} else {
return $.Deferred().reject( 'unknown error' );
}
} );
} );
}
}
module.exports = ImageInfo;