Troubleshooting
Bu sayfa, TypeScript’ın imzalama, açıklama, redaksiyon, çizim, dönüşüm ve metin API’leri için Aspose.PDF FOSS genelinde karşılaşılan en yaygın sorunların çözümlerini toplar.
Asenkron Yöntemler (Sign, Certify, VerifySignatures) Hiçbir Şey Yapmıyor Gibi Görünüyor
Document.Sign(), Document.Certify() ve Document.VerifySignatures() hepsi bir Promise döndürür. await olmadan birini çağırmak, yürütmenin hemen devam etmesini sağlar — ardından gelen bir doc.WriteTo() veya doc.Save(), imza aslında yazılmadan önce çalışabilir ve doğrulama sonucundaki bir console.log(), SignatureReport[] dizisi yerine çözümlenmemiş bir Promise kaydeder:
// Wrong — WriteTo can race ahead of Sign:
approving.Sign(identity, opts);
approving.WriteTo('signed.pdf');
// Correct:
await approving.Sign(identity, opts);
approving.WriteTo('signed.pdf');Bakınız Security tam sertifikalandır-ardından-imzala akışı için rehber.
SearchAnnotationText() ve SearchAnnotations() Aynı Metin İçin Farklı Sonuçlar Döndürür
Bu iki arama yöntemi aynı sayfada her iki yönde de ayrıdır. SearchAnnotationText() tam anotasyon meta verileriyle eşleşir (/Contents, /T, /Subj); SearchAnnotations() eşleşir rendered işaretleme anotasyonunun kendi görünümü tarafından çizilen metin (örneğin bir FreeText gövde). Yalnızca içinde saklanan bir değer /Contents birincisi tarafından bulunur, diğerince ise kaçırılır:
const metadataHits = page.SearchAnnotationText('confidential'); // matches /Contents, /T, /Subj
const renderedHits = page.SearchAnnotations('confidential'); // matches rendered markup text
Hiçbir yöntem normal sayfa metnini aramaz — kullan Page.GetText() or Page.Search() bunun için. Bakınız Açıklamalar tam açıklama API için kılavuz.
Bir Redaksiyon İşareti Tek Başına İçeriği Kaldırmaz
Page.AddRedact() sadece bir çizer RedactAnnotation bir bölge üzerine — altındaki içerik dokunulmamış ve hâlâ kopyalanabilir, şu ana kadar Page.ApplyRedactions() çalışır ve içerik akışını yıkıcı bir şekilde yeniden yazar. Eklenen işaretler after ApplyRedactions() zaten çalışmış ve süresiz olarak uygulanmaz kalır:
page.AddRedact({ rect: [216, 548, 460, 566], fill: [0, 0, 0], overlayText: '[REDACTED]' });
page.ApplyRedactions(); // only now is the content actually destroyed
Bakınız Redaction işaretleme-vs-uygulama ayrıntıları ve metin-ara kırpması için kılavuz.
PageGraphics Çizim Çağrıları Sayfada Asla Görünmez
Page.Graphics(), her moveTo()/rect()/circle()/stroke()/fill() çağrısını apply() sayfaya işleyene kadar tamponlayan bir PageGraphics döndürür. apply() çağrısı eksik bir dizi hiçbir şey çizmez:
const g = page.Graphics();
g.setStrokeColor([0.2, 0.2, 0.2]).setLineWidth(1).rect(80, 300, 200, 100).stroke();
g.apply(); // required — nothing above is visible without this call
Bakınız Images tam çizim ve isteğe bağlı içerik katmanı API için kılavuz.
Document.ToHtml() ve El-Tagleme İkisi de Bir Yapı Ağacına Bağlıdır
Semantik-mod Document.ToHtml(), içerikleri yapı ağacını dolaşarak yeniden akışa sokar; etiketlenmemiş bir belgede sessizce bir sezgisel gövdeye geri döner ve dışa aktarım başlık yapısını kaybeder. Aynı ağaç, el ile oluşturulan etiketlemenin (StructTreeRoot.Append() / StructElement.MarkContent()) yazdığı ve Document.GetStructTree()’ün döndürdüğü ağaçtır — Document.CreateStructTree() veya Document.AutoTag()’i ikisinden önce çağırın:
const root = doc.GetStructTree();
if (!root) throw new Error('document is not tagged yet');Bakınız Conversion and Structure sırasıyla dışa aktarma ve etiketleme API’leri için kılavuzlar.
AddTextBlock() Metni Sınır Dikdörtgeninde Sessizce Keser
Page.AddTextBlock(text, rect, options), metni rect içinde sarar ve sığmayan kısmı (veya her şey sığdıysa null) döndürür — dikdörtgeni büyütmez veya içerik taşarken hata atmaz. Yoksayılan bir dönüş değeri, taşan metnin basitçe hiç çizilmediği anlamına gelir:
const rest = page.AddTextBlock(longText, [72, 600, 200, 150], { fontSize: 11 });
if (rest) page.AddTextBlock(rest, [300, 600, 200, 150]); // route the overflow somewhere
Bakınız Text tam metin yerleştirme ve çıkarma API için kılavuz.
